LumeClip API and MCP for developers

Authentication

Create an API key yourself in Dashboard → Profile → API Key (free plan included) and send it as Authorization: Bearer YOUR_KEY to https://api.lumeclip.com. Keep it secret: it has full access to your account. Remote MCP connectors such as claude.ai sign in with OAuth 2.1 instead, with no key to copy.

Endpoints

Create a project, poll it until the status is DONE, then fetch and download each clip. Processing reserves minutes from the balance when the project is created. The full machine-readable description is in the OpenAPI spec.

curl -X POST https://api.lumeclip.com/api/projects \
  -H "Authorization: Bearer $LUMECLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sourceType":"YOUTUBE","sourceUrl":"https://www.youtube.com/watch?v=VIDEO_ID"}'

curl https://api.lumeclip.com/api/projects/PROJECT_ID \
  -H "Authorization: Bearer $LUMECLIP_API_KEY"

curl https://api.lumeclip.com/api/clips/CLIP_ID \
  -H "Authorization: Bearer $LUMECLIP_API_KEY"

curl -L -o clip.mp4 https://api.lumeclip.com/api/clips/CLIP_ID/download \
  -H "Authorization: Bearer $LUMECLIP_API_KEY"

MCP server

The hosted MCP server lives at https://api.lumeclip.com/mcp (Streamable HTTP). Tools: create_project, get_project_status, list_clips and get_clip_url. In Claude Code, Cursor or VS Code, send the API key in the Authorization header. On claude.ai, add a custom connector with the same URL and sign in.

{
  "mcpServers": {
    "lumeclip": {
      "type": "http",
      "url": "https://api.lumeclip.com/mcp",
      "headers": { "Authorization": "Bearer lc_your_key" }
    }
  }
}

OAuth scopes

lumeclip:read lets the agent see your projects and clips. lumeclip:create lets it create projects, which spends minutes. offline_access keeps it connected. You choose on the consent screen and can disconnect anytime in Profile → Connected apps. OAuth tokens are valid only on the MCP server.

Limits

MCP: 120 calls per minute per account. REST: 100 requests per minute per IP, and 20 new projects per hour. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset; a 429 also carries Retry-After, in seconds. Errors come as JSON with error (a message) and, when present, code (stable, for your code to branch on). Every processed video uses minutes from your plan.

Versioning and changes

This is version 1 of the API. New fields and optional parameters can be added at any time. A breaking change is announced at least 30 days in advance on this page, and the affected operations return the Deprecation and Sunset headers during that window.

Machine-readable files

• https://www.lumeclip.com/openapi.json
• https://www.lumeclip.com/llms.txt
• https://www.lumeclip.com/.well-known/mcp.json
• https://api.lumeclip.com/.well-known/oauth-protected-resource
• https://api.lumeclip.com/.well-known/oauth-authorization-server