MCP for agents

Give your AI agent access to your nimo sites, reports, history, monitoring, and connected analytics.

Set up your agent

Paste this into Claude Code, Cursor, Windsurf, or another agent. It will add Nimo, send you a sign-in link to approve, and verify the connection.

Set up Nimo using https://heynimo.com/docs/mcp.md.

What your agent can do

One connection gives your agent guided workflows for the jobs below:

• Audit my site — inspect a URL or saved site.
• Make my site faster — find and fix one high-impact issue.
• Find my best SEO action — choose one source-backed search action.
• Create a landing-page performance contract — define safeguards before a change.
• Verify a deployed performance fix — compare matching before-and-after evidence.

No separate skill installation is required. Ask your coding agent to read the latest nimo report before it changes code so it works from the page, metric, and recommendation that matter.

Connect your account

Sign in with your browser. You do not need an API key, and your agent never sees a secret.

Claude Code

claude mcp add --transport http --scope user nimo https://api.heynimo.com/mcp-server
claude mcp login nimo

Codex

codex mcp add nimo --url https://api.heynimo.com/mcp-server

Codex opens the sign-in page as soon as the server is added. If it does not, run codex mcp login nimo.

Cursor, Windsurf, and other clients: add https://api.heynimo.com/mcp-server as a user-level MCP server. Clients that support MCP sign-in open the browser for you.

Approve access in the browser and you are done. The connection stays signed in and renews itself while you use it; it ends after 30 days without use, or when you disconnect it in Settings → Integrations → Nimo MCP.

If you are an agent setting this up: add the server at user level, then start the sign-in yourself (run claude mcp login nimo, or call the Nimo server's authenticate tool if your client exposes one) and give the user the link to approve. Do not ask the user to run /mcp or create an API key.

Use an API key instead

Use a key only when your client cannot sign in with a browser. In Settings → API keys, create a key; it starts with nimo_ and is shown once. Store it in your client's local secret store as NIMO_API_KEY, never in agent chat or a repository, and send it as a bearer header:

{
  "mcpServers": {
    "nimo": {
      "url": "https://api.heynimo.com/mcp-server",
      "headers": { "Authorization": "Bearer <client-secret-reference-for-NIMO_API_KEY>" }
    }
  }
}

Replace the placeholder only through your client's documented environment or secret-reference syntax. Windsurf stores user-level MCP configuration in ~/.codeium/windsurf/mcp_config.json and calls the URL field serverUrl.

MCP access requires an active paid or comped plan. In ChatGPT, an account without a plan can still run one-off page checks. The connection can read account data and trigger audits, so disconnect agents and revoke keys you no longer use.

Try Nimo without an account

Connect your assistant to https://api.heynimo.com/try-mcp with no login or API key. Ask: “What is slowing down https://example.com?”

Nimo returns measurements and suggested fixes. Open the result link to save one check with Google. Free checks share hourly and daily limits, and unsaved results are temporary.

WebMCP for browser agents

WebMCP gives an agent a few safe actions on the Nimo page it has open—like buttons made for the agent. There is nothing to connect and no API key to add.

When Site tools appear in a supported browser or agent, start_website_check starts a public check and get_current_free_audit reads the visible result. They cannot sign in, create an account, choose a plan, enter payment details, buy anything, or read hidden report data. If Site tools do not appear, use the page normally or connect https://api.heynimo.com/try-mcp.

Public docs MCP

Use https://api.heynimo.com/docs-mcp when an agent only needs public Nimo documentation. It is read-only, needs no API key, and provides list_docs, search_docs, read_doc, and read_llms_full.

Use the account MCP for saved sites, reports, history, monitoring, integrations, and Journey Watch.

Support

For help with a connection or a tool result, email hello@heynimo.com and name the client you use (for example ChatGPT, Claude Code or Cursor). To disconnect an assistant, open Settings → Connected agents. For privacy questions, see the privacy policy.

Advanced options

• Add ?profile=optimize for performance and SEO, ?profile=monitoring for watched pages and uptime, ?profile=integrations for PostHog and GA4, or ?profile=journeys to create, manage, run, and inspect Journey Watch goals. Reconnect when changing profiles.
• The optional deeper Agent Skill lives at https://heynimo.com/.well-known/agent-skills/nimo-performance-agent/SKILL.md. Save it in your client's user-level skills directory only when you want the longer coding-agent playbook.
• Keep credentials out of chat, commands, logs, and repository files. Never commit a raw API key in a project-level .mcp.json. If you are an agent, summarize the required setup steps before changing the user's system, and ask for approval before installing software, changing configuration, exposing data, or taking another setup action with side effects.