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.

MCP client

# Claude Code

claude mcp add nimo https://api.heynimo.com/mcp-server -t http -s project -H "Authorization:Bearer nimo_..."

# Now ask

Compare my last two audits and tell me what changed.

What the MCP server gives agents

The MCP server lets an agent inspect your sites, read audit reports, compare performance history, start audits, and check uptime. This is useful when you want an AI coding agent to connect recommendations to real data instead of guessing.

Idea

Ask your coding agent to read the latest nimo report before it changes code. It can then target the page, metric, and recommendation that matter most.

Public docs MCP

Use this endpoint when an agent only needs public nimo docs:

https://api.heynimo.com/docs-mcp

It is read-only and does not need an API key. Tools include list_docs, search_docs, read_doc, and read_llms_full.

Create an API key

Open Settings

Go to Settings and find API keys.

Create a key

Give the key a clear name like Claude Code or Cursor.

Copy it once

nimo shows the key only once. It starts with nimo_.

Paste it into your MCP client

Use it as a bearer token in the Authorization header.

Connect your client

Use the command or config that matches your agent.

claude mcp add nimo https://api.heynimo.com/mcp-server -t http -s project -H "Authorization:Bearer nimo_YOUR_KEY"

{
  "mcpServers": {
    "nimo": {
      "url": "https://api.heynimo.com/mcp-server",
      "headers": {
        "Authorization": "Bearer nimo_YOUR_KEY"
      }
    }
  }
}

For Windsurf, add the same server URL and bearer header in ~/.codeium/windsurf/mcp_config.json.

Available MCP tools

list_sites

List every site connected to the API key owner.

get_site

Read one site's latest status and metadata.

get_audit_report

Fetch a full audit report for a known audit ID.

get_audit_history

List previous audits for a site.

compare_audits

Compare metrics between two audits.

run_audit

Start a new audit from an MCP client.

get_audit_status

Check a queued or running audit.

get_uptime_status

Read uptime and incident status for a site.

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 other automation that can read account data and trigger audits.

Agent prompt

Use the nimo MCP server to inspect my latest audit, identify the highest-impact code change, and propose a minimal patch.

Connect an AI agent

Create an API key, add the MCP server, and let your coding agent work from real performance data.

Get started