faktry

faktry MCP

Bring the whole faktry media stack into the tools you already use.

Generate and edit images, video, audio, and PDFs from any MCP-compatible client.

Install · Tools · Examples · Troubleshooting

The faktry MCP server exposes the full faktry toolkit — over 70 tools spanning image, video, audio, PDF, and 3D generation and editing — to any client that speaks the Model Context Protocol. Generate a product shot, cut it into a UGC-style video with a voiceover, subtitle it, and export a thumbnail sheet, all without leaving the chat.

• Hosted, remote. Connect to https://faktry.ai/api/mcp — no local server to run. stdio-only clients can use the npx -y @faktry/mcp bridge.
• OAuth or API key, your choice. One-click connect from Claude.ai, Claude Desktop, Cursor, and Hermes, or drop a static API key into any config-based client.
• Async by default. Long-running jobs (video, some image/audio) return a job_id immediately; poll faktry_job_status until it's ready.
• A library that remembers. Save any result with faktry_library_save and pull it back into a later session with faktry_library_list.
• You pay through your faktry account. Usage draws down your existing credit balance — check it anytime with faktry_credits.

Install

One-click / OAuth

These clients handle authentication for you — paste the URL, sign in, approve.

MCP Server URL:

https://faktry.ai/api/mcp

Claude.ai

1. Open Claude.ai → Settings → Integrations.
2. Click Add MCP Server and paste the URL above.
3. Claude.ai redirects you to faktry — sign in and click Approve.
4. Done — Claude.ai stores the token automatically.

Claude Desktop

1. Open Claude Desktop → Settings → Developer → MCP Servers.
2. Click Add Server and paste the URL above.
3. A browser window opens — sign in to faktry and click Approve.
4. Restart Claude Desktop if tools don't appear immediately.

Cursor

1. Open Cursor → Settings → AI → MCP Servers.
2. Click Add MCP Server and paste the URL above.
3. Cursor detects OAuth and opens a browser login window.
4. Sign in to faktry, approve access, and return to Cursor.

Hermes Agent

1. Open Hermes Agent → Settings → MCP Servers.
2. Click + and paste the URL above.
3. Hermes opens a browser login — sign in to faktry and approve.
4. Toggle the server on — tools appear immediately.

ChatGPT Desktop (Business / Enterprise / Edu only)

1. Enable Developer Mode in Settings → Beta Features.
2. Go to Settings → MCP Servers → Add Server.
3. Paste the URL above and follow the browser OAuth flow.

Config file / API key

Create an API key at faktry.ai/api/keys first, then add faktry to your client's config. Replace YOUR_API_KEY_HERE with your real key — it's only shown once when created.

Claude Code

Add to .mcp.json (project) or ~/.claude.json (user):

{
  "mcpServers": {
    "faktry": {
      "type": "http",
      "url": "https://faktry.ai/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY_HERE" }
    }
  }
}

Picked up automatically — no restart needed.

VS Code (Copilot)

Add to .vscode/mcp.json (workspace) or via Settings → MCP Servers:

{
  "servers": {
    "faktry": {
      "type": "http",
      "url": "https://faktry.ai/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY_HERE" }
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json (%USERPROFILE%\.codeium\windsurf\mcp_config.json on Windows) — note Windsurf uses serverUrl, not url:

{
  "mcpServers": {
    "faktry": {
      "serverUrl": "https://faktry.ai/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY_HERE" }
    }
  }
}

Restart Windsurf to activate the tools.

Continue.dev

Add to ~/.continue/config.yaml:

mcpServers:
  faktry:
    type: http
    url: https://faktry.ai/api/mcp
    requestOptions:
      headers:
        Authorization: "Bearer YOUR_API_KEY_HERE"

Continue.dev reloads automatically.

Codex CLI

Add to ~/.codex/config.toml:

[mcp.servers.faktry]
type = "http"
url = "https://faktry.ai/api/mcp"

[mcp.servers.faktry.headers]
Authorization = "Bearer YOUR_API_KEY_HERE"

Verify with codex mcp list.

stdio clients (npx) — Zed, older Claude Desktop configs, and anything without remote MCP

The @faktry/mcp package is a thin stdio bridge to the hosted server. Requires Node 18+.

Generic form:

FAKTRY_API_KEY=YOUR_API_KEY_HERE npx -y @faktry/mcp

Claude Desktop (claude_desktop_config.json) and most other mcpServers clients:

{
  "mcpServers": {
    "faktry": {
      "command": "npx",
      "args": ["-y", "@faktry/mcp"],
      "env": { "FAKTRY_API_KEY": "YOUR_API_KEY_HERE" }
    }
  }
}

Zed (settings.json, %APPDATA%\Zed\settings.json on Windows):

{
  "context_servers": {
    "faktry": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "@faktry/mcp"],
      "env": { "FAKTRY_API_KEY": "YOUR_API_KEY_HERE" }
    }
  }
}

Leave FAKTRY_API_KEY out to sign in through the browser (OAuth) instead.

Kilo Code

1. Open the Kilo Code extension settings → MCP Servers.
2. Add a new server using the same JSON snippet as Claude Code above.
3. Replace YOUR_API_KEY_HERE with your actual key.

Other MCP clients

Add a remote HTTP server pointing at https://faktry.ai/api/mcp with header:

Authorization: Bearer YOUR_API_KEY_HERE

Full per-client snippets and paths are also generated at faktry.ai/mcp.

Tools

Your client picks which tool to call based on your prompt — you don't need to invoke them by name. faktry exposes 70+ tools across five categories:

Plus utility tools:

The async job pattern

Most generation tools (video, some image/audio) are async:

1. Call the generation tool → receive a job_id.
2. Poll faktry_job_status with that job_id every few seconds.
3. When status is completed, the response contains result_url.
4. Optionally persist it with faktry_library_save.

Example prompts

Try these once faktry is connected:

Generate a studio product shot of a matte black wireless speaker on a
white background, then upscale it to 4K.

Turn this product image into a 9:16 UGC-style video with a voiceover
reading the description, and add subtitles.

Remove the background from this photo, then composite it onto a
gradient backdrop.

Clone this voice sample and generate a 30-second narration reading
this script.

Check my faktry credits, then show me what's in my library.

Troubleshooting

Tools don't appear after connecting

• Claude.ai / Desktop: Settings → Integrations (or Developer → MCP Servers), confirm faktry shows as connected. Remove and re-add if it failed silently — make sure pop-ups aren't blocked so the OAuth window can open.
• Claude Code: claude mcp list should show the server.
• Codex: codex mcp list should show faktry. Start a new session after adding.
• Quick smoke test: ask your client "check my faktry credits".

Authentication or API key errors

• For config-file clients, confirm YOUR_API_KEY_HERE was replaced with a real, active key from faktry.ai/api/keys — keys are shown only once at creation.
• For OAuth clients, disconnect and reconnect the connector to redo the flow.

A generation keeps loading

Video renders and some audio/image jobs take longer than a plain image generation. The tool returns a pending job_id immediately — keep polling faktry_job_status until it reports completed.

Links

• MCP setup UI — faktry.ai/mcp
• API keys — faktry.ai/api/keys
• faktry — faktry.ai

License

MIT © faktry