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

  1. Create an account. Sign up at https://arcmira.com/sign-up, or POST https://api.arcmira.com/v1/signups with {"email"}, then POST https://api.arcmira.com/v1/signups/verify with the six digit code from that inbox.
  2. Mint a key. Create one at https://arcmira.com/dashboard/api. The verify call above already returns one.
  3. First request.
    curl https://api.arcmira.com/v1/me -H "Authorization: Bearer arc_sk_..."
  4. 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
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 setup connects the MCP server and the Arcmira skills to Claude Code, Codex, Cursor, VS Code, Gemini CLI and Claude Desktop, with updates on.

MCP server

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.resolve first.

Plugin for Claude Code

claude plugin marketplace add arcmira/mcp, then claude 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_...

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
The Arcmira skill for chat assistants
https://arcmira.com/.well-known/skills/arcmira/SKILL.md