Docs/Install MCP

Install MCP

The miromiro-mcp server exposes every endpoint as a tool your agent can call natively - no code. It runs locally as npx miromiro-mcp and reads your key from MIROMIRO_API_KEY. All seven extract tools appear automatically.

Claude Code is configured with the claude mcp add command - run it in your terminal, not inside a claude session. Cursor and Windsurf take a JSON mcpServers block instead - pick your client below.

Authorization: Bearer mm_live_…

What each piece does

  • npx -y miromiro-mcp - downloads the miromiro-mcp package from the npm registry and runs it. Nothing to install or update by hand - -y skips the "install this package?" prompt so your editor can start it unattended.
  • MIROMIRO_API_KEY - your key from the dashboard. The server reads it from the environment and sends it as the bearer token on every call. It stays in your local config - it is never shown to the agent or sent anywhere except miromiro.app.
  • command + args - how your editor launches the server: a small local process on your machine that translates the agent's tool calls into HTTPS requests to miromiro.app/api/v1. It talks to nothing else.
  • -s user (Claude Code) - registers the server for every project on your machine. Drop it to scope to the current project only.

Config paths - Claude Code: registered via claude mcp add (use claude mcp list to verify) · Cursor: ~/.cursor/mcp.json · Windsurf: its MCP settings · Package: miromiro-mcp on npm.