Connect AI Assistants
OyeFilmy MCP Server
OyeFilmy MCP is a remote server built on the Model Context Protocol. Once connected, your AI assistant (Claude, ChatGPT, Cursor, Windsurf, Claude Code) can generate images and videos, synthesize audio, build 3D models, upscale assets, and search your creation history directly from your chat prompt.
Remote Server Endpoint: https://api.oyefilmy.com/api/mcp
Uses Streamable HTTP (SSE / JSON-RPC 2.0). No local bridge or binary installation required.
Getting started
1. OyeFilmy Account
Any OyeFilmy account works. MCP tools share your existing credit balance.
2. Add Server
Add https://api.oyefilmy.com/api/mcp in your AI client's MCP settings.
3. Approve Auth
Sign in with your OyeFilmy account or provide your API Key when prompted.
4. Start Creating
Ask your assistant to generate, upscale, or search. It picks the right tool automatically.
Connect your client
- Open Claude and click your profile avatar in the bottom-left corner, then select Customize.
- Go to Connectors and click Add connector.
- Select Add custom connector.
- Enter Name:
OyeFilmyand URL:https://api.oyefilmy.com/api/mcp. - Complete the sign-in when prompted.
- Start chatting! Ask Claude: "Generate a futuristic drone video in 4K using Seedance 2.0".
Available MCP tools
The MCP server advertises these tools via tools/list. Your AI agent calls them autonomously based on your prompts:
| Tool Name | Category | Description |
|---|---|---|
account_balance | Account | Current credit balance, plan name, and subscription expiration |
images_generate | Image Generation | Generate images with prompt, aspectRatio, styleRef, charRef, brandId across 145 image models |
video_generate | Video Generation | Generate videos (T2V, I2V, start-end frame) with prompt, aspectRatio, duration across 195 video models |
audio_generate | Audio & Speech | Generate music (MiniMax Music 2.6), speech (ElevenLabs v3, xAI TTS, Gemini TTS) and sound effects |
models3d_generate | 3D Generation | Generate 3D GLB mesh objects from text or image input via Tripo3D / Meshy3 |
images_upscale | Image Editing | AI image upscaling — 2x, 3x or 4x, returned as PNG |
video_upscale | Video Editing | AI video upscaling to 1080p or 2K |
images_remove_background | Image Editing | Extract main subject with transparent PNG alpha cutout |
creations_search | History & Search | Search user's historical generation library by prompt keyword, type, and date |
creations_get | History & Search | Retrieve detailed metadata, model settings, and download URL for an asset ID |
creation_status | Jobs & Polling | Poll live status of an in-flight background generation job |
creations_wait | Jobs & Polling | Synchronously wait for an async generation job to complete |
models_list | Catalog | List all available OyeFilmy model keys, providers, categories, and credit costs |
brand_dna_list | Brand DNA | List active Brand DNA profiles for brand-consistent AI generation |
Frequently asked questions
How does OyeFilmy connect to AI agents?
OyeFilmy runs a remote server that speaks the Model Context Protocol over Streamable HTTP. Any MCP-compatible client connects directly to https://api.oyefilmy.com/api/mcp and calls OyeFilmy tools right from the chat.
Do I need an API key?
Yes. Authenticate with an OyeFilmy API key (of_live_…) sent as a bearer token — create one on the API Keys page. initialize and tools/list answer without credentials so a client can discover the tools, but every tool that touches your account or spends credits requires the key, and it must carry the right scope for what you ask (generate:image, generate:video and so on). OAuth is not supported yet.
How does credit billing work?
MCP tool invocations draw from the exact same credit balance as your main OyeFilmy account. Each generation deducts credits based on the model tier and quality selected.
Can my agent search my past creations?
Yes! The creations_search and creations_get tools allow your agent to look through your historical generations and use previous assets as inputs for video, upscaling, or editing.