MCP server & REST API — for developers and Claude users
MCP server & REST API — for developers and Claude users
Weftly is an MCP server for video processing. Every tool — transcribe, summarize, find clips, cut horizontal and vertical clips — is one MCP call. Works in Claude Desktop, claude.ai, Claude Code, Cursor, and any MCP-compatible host. Pay per job with a card or USDC. No subscription.
No code. No crypto wallet. Add Weftly as a connector and pay by card whenever you run a job. Works in Claude Desktop, claude.ai, and VS Code Copilot.
In Claude Desktop: open Settings → Integrations and add a custom MCP server.
On claude.ai: open Settings → Integrations and paste the endpoint URL.
https://api.weftly.ai/mcpDrop a file into Claude or reference a URL and ask naturally:
"Transcribe this podcast recording"
"Find the best clips from this interview"
"Summarize this meeting — give me the key points"When a paid job runs, Claude surfaces a Stripe Checkout link — click it, pay by card, and Claude automatically resumes the job. No wallet setup required.
Claude delivers your transcript, summary, or clip candidates directly in the chat — with download links that are valid for 24 hours.
Install the Weftly plugin to wire up the MCP server and payment signing automatically. Agents pay in USDC on the Tempo network via mppx — no checkout required. Prefer to skip the wallet? Skip step 1; every paid call also returns a Stripe Checkout link you can open in a browser.
mppx is the payment CLI that handles USDC payments autonomously.
# Install mppx and create a wallet
npx mppx account create
npx mppx account view # copy the wallet addressFund with USDC on the Tempo network. A few dollars covers many jobs — most cost $0.50–$2.00. See github.com/wevm/mppx for the CLI.
In Claude Code, run:
/plugin marketplace add woven-record-media/weftly-plugins
/plugin install weftly-setup@weftly
/weftly-setup:weftly-setup --wallet <your-wallet-address>This registers the MCP server at api.weftly.ai/mcp and configures automatic MPP payment signing — so Claude can pay and retry without interrupting you.
"Transcribe interview.mp4"
"Find clips from this call recording"
"Summarize the meeting and give me show notes"Claude handles the upload, payment, and polling automatically. You get the result when it's done.
Full OpenAPI spec. Same job pipeline as the MCP server — create, upload, pay, poll, download. Supports MPP (USDC via mppx) and Stripe Checkout for payment.
https://api.weftly.ai/.well-known/openapi.json# Create a session
POST /api/v1/sessions
# Create a job (returns upload URL + payment info)
POST /api/v1/jobs { type: "transcribe", filename: "episode.mp3" }
# Upload the file
PUT <presigned-upload-url> <file bytes>
# Pay via Stripe or MPP, then complete upload
POST /api/v1/jobs/:id/complete-upload
# Poll until done
GET /api/v1/jobs/:idThe API returns HTTP 402 with an MPP challenge when payment is required. Sign the challenge with mppx and retry with Authorization: Payment <credential>. Stripe Checkout is also supported for user-facing flows — see payment_url in the 402 response.
Weftly speaks plain MCP Streamable HTTP — no SDK required, no session, no API key. Payment-per-call is the auth. Below is everything to call the server from any MCP-aware client or your own code. All snippets are real captures from api.dev.weftly.ai/mcp.
Single endpoint. Stateless — no Mcp-Session-Id is issued or required. No registration.
# MCP Streamable HTTP · JSON-RPC 2.0 · protocol version 2025-03-26
https://api.weftly.ai/mcpAn initialize call returns serverInfo.name = "weftly" and the server's instructions (the same tool-selection guidance the MCP host receives).
curl -X POST https://api.weftly.ai/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-03-26" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Returns 8 tools — the 5 product tools plus three lifecycle helpers: transcribe, summarize, find_clips, extract_clip, extract_vertical_clip, complete_upload, get_job_status, mpp_smoke_test. Each carries its own JSON Schema in inputSchema — discover at runtime, no docs scraping.
curl -X POST https://api.weftly.ai/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-03-26" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
"params":{"name":"transcribe",
"arguments":{"filename":"podcast.mp3"}}}'The response wraps a payment_required envelope inside the standard MCP text content block. Parse the inner JSON to get the dual-rail challenge:
{
"error": {
"type": "payment_required",
"job_id": "8cd079ef-1afb-4a03-bc50-fb5410d080b4",
"job_type": "transcribe",
"amount_cents": 50,
"currency": "USD",
"rails": ["tempo", "stripe_spt"],
"payment_challenge": {
"scheme": "Payment",
"www_authenticate": "Payment id=\"...\", method=\"tempo\", request=\"<b64url>\", expires=\"...\",
Payment id=\"...\", method=\"stripe\", request=\"<b64url>\", expires=\"...\""
},
"payment_url": "https://checkout.stripe.com/c/pay/cs_test_...",
"expires_at": "2026-05-04T16:33:48.587Z",
"retry_hint": "..."
}
}Crypto path (autonomous). Sign payment_challenge.www_authenticate with mppx and re-call the same tool with job_id and payment_credential = "Payment <jwt>". Returns a presigned upload URL.
Card path (human-in-the-loop). Open payment_url in a browser. Once the Stripe webhook lands, re-call the same tool with just job_id — the upload URL comes back the same way.
Then PUT the file to the presigned URL, call complete_upload(job_id), and poll get_job_status(job_id) until status: "completed". Outputs come back as presigned download URLs valid for 24h.
Five product tools plus two lifecycle helpers. All tools run through the same payment gate — pay once per job.
| Tool | What it does | Price | Status |
|---|---|---|---|
| transcribe | Word-level SRT + JSON transcript from any audio or video file. Editor-ready timestamps, full text. | $0.50 audio $1.00 video |
Live |
| summarize | AI summary (key points, topics, action items) plus the full SRT transcript in one call. | $0.75 audio $1.25 video |
Live |
| find_clips | Analyzes a video and returns ranked clip candidates — titles, hooks, timestamps, full text, score. Transcript is a free byproduct. | $2.00 | Live |
| extract_clip | Cut one or more segments from a prior job into a composed horizontal MP4. No re-upload. Same flat price for single cut or multi-segment reel. | $0.50 / cut | Live |
| extract_vertical_clip | Cut a 9:16 vertical short from a prior job — center-cropped, ≤90 seconds, ready for TikTok, Reels, and Shorts. | $0.50 / cut | Live |
| complete_upload | Lifecycle — call after PUT-ing a file to start processing. Mirrors POST /jobs/:id/complete-upload. | ||
| get_job_status | Lifecycle — poll status, retrieve download URLs, or recover a lost payment challenge or upload URL. | ||
Weftly detects your host and returns the right payment method. You never need to configure this — it just works.
When you're in a browser-based MCP host, the payment_required
response includes a Stripe Checkout link. Click it, pay by card or
Apple/Google Pay, and Claude resumes the job automatically. No wallet required.
Agent hosts sign the MPP challenge with mppx — sub-second, no human in the loop. Fund a wallet once; the agent pays autonomously per job. On-chain receipt for every transaction.
What Weftly's MCP server does, how to connect it, and how payment works.
Weftly is an MCP (Model Context Protocol) server that gives Claude and other AI agents
video processing tools — transcribe, summarize, find clips, and cut horizontal or
9:16 vertical clips. The endpoint is https://api.weftly.ai/mcp. It's
pay-per-job with no subscription and no account.
In Claude Desktop, open Settings → Connectors → Add custom connector
and paste the MCP server URL https://api.weftly.ai/mcp. No code or crypto wallet
required — the first time you run a paid tool, Weftly returns a Stripe Checkout link and
you pay by card.
Claude Desktop, claude.ai, Claude Code, VS Code Copilot, Cursor, Goose, and any
MCP-compatible host. Terminal and agent hosts can pay with USDC via mppx;
browser-based hosts pay by card through Stripe Checkout.
Yes — Weftly is an MCP server built for video. It transcribes audio and video to SRT, summarizes long recordings, finds the best clip candidates in a long video, and cuts horizontal or vertical clips for TikTok, Reels, and Shorts. Each tool is a single MCP call.
Pay-per-job: $0.50–$2.00 per call, no subscription. Calling a paid
tool returns a payment challenge. Terminal and agent hosts sign it with USDC via
mppx; browser MCP hosts open a Stripe Checkout link and pay by card. Once
paid, the tool runs.
No. A crypto wallet is optional. Browser-based MCP hosts like Claude Desktop and claude.ai
pay by card through Stripe Checkout. A wallet (via mppx) is only needed for
fully automated agent payments with USDC.
Add the MCP endpoint and start building — or try the browser chat first to see what the tools return.