@faktry/mcp
Advanced tools
stdio bridge to the hosted faktry MCP server. Generate and edit images, video, audio, and PDFs from any MCP client.
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.job_id immediately; poll faktry_job_status until it's ready.faktry_library_save and pull it back into a later session with faktry_library_list.faktry_credits.These clients handle authentication for you — paste the URL, sign in, approve.
MCP Server URL:
https://faktry.ai/api/mcp
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.
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.
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" }
}
}
}
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.
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.
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.
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.
YOUR_API_KEY_HERE with your actual key.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.
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:
| Category | Examples | What it covers |
|---|---|---|
faktry_image_* | generate, edit, inpaint, outpaint, upscale, removebackground, effects, collage, watermark, smartcrop | Text-to-image, editing, upscaling, background removal, compositing |
faktry_video_* | text2video, image2video, avatar, motioncontrol, subtitle, reframe, stabilize, upscale, scenedetect | Generation, editing, avatars, motion control, subtitles, reframing |
faktry_audio_* | generatespeech, clonevoice, generatemusic, generatesound, mix, transcribe, trim | Speech synthesis, voice cloning, music/SFX generation, mixing |
faktry_pdf_* | create, merge, split, compress, extract, mdconvert | PDF creation and manipulation |
faktry_3d_* | image23d, text23d | 3D asset generation from images or text |
Plus utility tools:
| Tool | What it does |
|---|---|
faktry_job_status | Poll an async job by job_id until it's completed, returning result_url |
faktry_credits | Check credit balance and current-month usage |
faktry_library_list | Browse previously saved media assets |
faktry_library_save | Save a result URL to the library for reuse across sessions |
Most generation tools (video, some image/audio) are async:
job_id.faktry_job_status with that job_id every few seconds.completed, the response contains result_url.faktry_library_save.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.
claude mcp list should show the server.codex mcp list should show faktry. Start a new session after adding.YOUR_API_KEY_HERE was replaced with a real, active key from faktry.ai/api/keys — keys are shown only once at creation.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.
MIT © faktry
FAQs
stdio bridge to the hosted faktry MCP server. Generate and edit images, video, audio, and PDFs from any MCP client.
The npm package @faktry/mcp receives a total of 30 weekly downloads. As such, @faktry/mcp popularity was classified as not popular.
We found that @faktry/mcp demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Threat Research
Malicious Firefox extensions mimic Phantom, Jupiter, and Bitget wallets to steal recovery phrases and private keys, with one fetching its payload remotely.
Product
Socket Threat Intel now shows which malware campaigns were blocked or detected in your organization, with links to scans and Firewall events.
Security News
Fixes for eMudhra and Brotli are out. Getting them everywhere they’re needed means tracking down bundled libraries, runtimes, and certificate stores.