Developers
Arcmira Developers
API docs, authentication and agent setup for YouTube transcript search, speaker appearances, mentions, sponsors and recommendations.
Agents: this page is also available as markdown at /developers.md.
Canonical https://arcmira.com/developers. Documentation at https://arcmira.com/docs.
Four steps
Quickstart
- Create an account. Sign up at https://arcmira.com/sign-up, or
POSThttps://api.arcmira.com/v1/signups with{"email"}, thenPOSThttps://api.arcmira.com/v1/signups/verify with the six digit code from that inbox. - Mint a key. Create one at https://arcmira.com/dashboard/api. The verify call above already returns one.
- First request.
curl https://api.arcmira.com/v1/me -H "Authorization: Bearer arc_sk_..."
- Connect an agent. Point any MCP client at https://mcp.arcmira.com/mcp over Streamable HTTP and sign in through the host.
The Arcmira API
- API documentation
- https://arcmira.com/docs
- Base URL
- https://api.arcmira.com/v1
- OpenAPI 3.1 spec
- https://api.arcmira.com/v1/openapi.json
- API catalog (RFC 9727)
- https://arcmira.com/.well-known/api-catalog
- Authentication guide for agents
- https://arcmira.com/auth.md
- YouTube transcript API
- https://arcmira.com/transcript-api
Transcripts by video id, speakers on Premium, and search across videos, with curl, TypeScript and Python samples.
Libraries
- TypeScript and JavaScript
- https://www.npmjs.com/package/arcmira
npm install arcmira. A typed client with auto-paging lists and one error class per status. Source https://github.com/arcmira/arcmira - Python
- https://pypi.org/project/arcmira/
pip install arcmira. The same client for Python. Source https://github.com/arcmira/python - Command line
npx arcmira search "agent payments"searches timestamped transcript passages. It ships in the npm package.- Coding agents
npx arcmira setupconnects the MCP server and the Arcmira skills to Claude Code, Codex, Cursor, VS Code, Gemini CLI and Claude Desktop, with updates on.
MCP server
- Endpoint
- https://mcp.arcmira.com/mcp
- Transport
Streamable HTTP.
- Tools
Six: arcmira_describe returns the arcmira client reference; arcmira_execute_read runs a JavaScript program against that client; arcmira_execute_write adds monitor writes and Premium transcripts; arcmira_youtube_search finds where something was said; arcmira_youtube_transcript reads a whole transcript; arcmira_feedback reports what went wrong. Filters take ids: resolve a name with
arcmira.resolvefirst.- Plugin for Claude Code
claude plugin marketplace add arcmira/mcp, thenclaude plugin install arcmira@arcmira. Adds the server and the Arcmira skills. Turn on auto-update in /plugin, Marketplaces, arcmira: Arcmira ships weekly.- Auth
OAuth through the host by default. A host that cannot sign in sends an account key as
Authorization: Bearer arc_sk_...- Discovery file
- https://arcmira.com/.well-known/mcp
- Overview
- https://arcmira.com/mcp
- Setup for each host
- https://arcmira.com/agent-setup
- Reference
- https://arcmira.com/docs/mcp-server
Rate limits
Requests are rate limited per credential. Over the limit the API returns 429 with Retry-After when present. Agents should treat any 429 as a signal to retry with exponential backoff rather than tight-looping.
Versioning
The version is /v1 in the path. Changes are listed at https://arcmira.com/docs/changelog.md.
Machine-readable entry points
- Site index for agents, routed by situation
- https://arcmira.com/llms.txt
- The whole auth model in one fetch
- https://arcmira.com/auth.md
- MCP server discovery with its tool list
- https://arcmira.com/.well-known/mcp
- Search and read these public docs through MCP, no credential
- https://arcmira.com/docs/mcp
- RFC 9727 linkset for the API
- https://arcmira.com/.well-known/api-catalog
- The Arcmira skill for chat assistants
- https://arcmira.com/.well-known/skills/arcmira/SKILL.md