# MCP for agents

Use the public docs MCP when an agent only needs nimo documentation. Use the authenticated nimo MCP server when an agent needs your performance data.

Canonical URL: https://heynimo.com/docs/mcp
Markdown URL: https://heynimo.com/docs/mcp.md

## AI summary

Shows how to use the public docs MCP server, create a nimo API key, configure remote MCP clients with bearer auth, and use the nimo MCP tools for sites, audit reports, history, comparisons, and uptime.

## Key points

- Use the public docs MCP at https://api.heynimo.com/docs-mcp when an agent only needs public nimo documentation.
- Create an API key in Settings. Keys start with nimo_ and are shown once.
- Connect an HTTP MCP client to https://api.heynimo.com/mcp-server.
- Send Authorization: Bearer nimo_YOUR_KEY.
- Tools include list_sites, get_site, get_audit_report, get_audit_history, compare_audits, run_audit, get_audit_status, and get_uptime_status.

## Sections

### What the MCP server gives agents

- The MCP server lets an agent inspect sites, read audit reports, compare history, start audits, and check uptime.
- Ask your coding agent to read the latest nimo report before it changes code. It can target the page, metric, and recommendation that matter most.

### Public docs MCP

- Use https://api.heynimo.com/docs-mcp when an agent only needs public nimo documentation.
- This server is read-only and does not require an API key.
- Tools include list_docs, search_docs, read_doc, and read_llms_full.
- Use the authenticated nimo MCP server only when an agent needs account data such as sites, audits, history, or uptime status.

### Create an API key

- Open Settings and find API keys.
- Create a named key for a client such as Claude Code or Cursor.
- Copy it once. nimo shows the key only once, and it starts with nimo_.
- Paste it into the MCP client as a bearer token in the Authorization header.

### Connect your client

- Claude Code command: claude mcp add nimo https://api.heynimo.com/mcp-server -t http -s project -H "Authorization:Bearer nimo_YOUR_KEY"
- Generic MCP config: use url https://api.heynimo.com/mcp-server and header Authorization: Bearer nimo_YOUR_KEY.
- For Windsurf, add the same server URL and bearer header in ~/.codeium/windsurf/mcp_config.json.

### Security notes

- API keys are shown once. Store them in your agent secret store or local MCP config.
- Revoke keys you no longer use.
- Each user can have up to five keys.
- MCP access requires an active paid or comped plan.
- Treat MCP clients like any automation that can read account data and trigger audits.


## Related docs

- [Quick start](https://heynimo.com/docs) - Add a site, connect Telegram, and ask nimo what to fix first.
- [Set up a site](https://heynimo.com/docs/setup) - Add your site, pick a schedule, and understand what nimo checks.
- [Telegram](https://heynimo.com/docs/telegram) - Connect Telegram and use nimo from chat.
- [Audits](https://heynimo.com/docs/audits) - Run audits and read Core Web Vitals without the jargon.
- [Monitoring and alerts](https://heynimo.com/docs/monitoring) - Let nimo watch speed and uptime in the background.