MCP server

The MCP server exposes Clip Foundry to Claude Desktop, Cursor, and any MCP client over stdio. Add it to your client config:

json

{
  "mcpServers": {
    "clipfoundry": {
      "command": "npx",
      "args": ["-y", "@clipfoundry/mcp"],
      "env": { "CLIPFOUNDRY_API_KEY": "cf_live_..." }
    }
  }
}

Tools: create_short, get_job, list_jobs, cancel_job, list_styles, list_voices, get_balance. Ask your assistant to "make a Short about X" and it queues a job through your account.

Remote / web clients (Streamable HTTP)

For browser or hosted clients, run the HTTP transport instead of stdio:

bash

clipfoundry-mcp-http   # serves POST/GET/DELETE /mcp on :4100

It speaks the modern Streamable HTTP transport (SSE under the hood) with mcp-session-id sessions. Auth is per session — each client sends Authorization: Bearer <your-key> on initialize, so one server can serve many users. Point your remote MCP client at https://<host>/mcp.