DocsMCP server
Integration

Grademypage MCP

Use Grademypage audits, analytics, and Reddit leads from Claude, ChatGPT, or any MCP-compatible client.

What is MCP?

The Model Context Protocol (MCP) lets AI assistants call tools on external services. Grademypage MCP exposes read-only access to your landing page audits, analytics, domain grade, Reddit leads, and experiments in one place. That covers more than SEO-only MCP servers, which usually stop at keywords and backlinks.

Read-only v1
Current tools fetch data only. Triggering new audits or generating leads via MCP may come in a future release.

Create an API key

  1. Open Settings

    Go to Dashboard → Settings.

  2. Create a key

    Under MCP API keys, give the key a name (for example "Claude on MacBook") and click Create key.

  3. Copy it now

    Copy the full key when it appears. It is only shown once. Keys start with gmp_mcp_. Revoke any key from Settings if it is compromised.

Connect Claude

Grademypage uses API key authentication. Claude Desktop's Add custom connector dialog is built for OAuth servers and does not accept a static Bearer token. Use the developer config file instead, with mcp-remote to forward your API key on each request.

Do not use Add custom connector
Settings → Connectors → Add custom connector only works for OAuth MCP servers today. Grademypage will support that flow in a future release. For now, edit claude_desktop_config.json as shown below.

  1. Open the config file

    In Claude Desktop, go to Settings → Developer → Edit Config. On macOS the file is:

    ~/Library/Application Support/Claude/claude_desktop_config.json

    On Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Add Grademypage under mcpServers

    Merge a grademypage entry into the existing mcpServers object. Replace gmp_mcp_YOUR_KEY with your key. Keep any other servers you already have (for example PostHog).

    { "mcpServers": { "grademypage": { "command": "npx", "args": [ "-y", "mcp-remote@latest", "https://grademypage.com/api/mcp", "--header", "Authorization:${GMP_MCP_AUTH_HEADER}" ], "env": { "GMP_MCP_AUTH_HEADER": "Bearer gmp_mcp_YOUR_KEY" } } } }

    The env value must include the Bearer prefix. The header line uses Authorization:${GMP_MCP_AUTH_HEADER} with no space after the colon, matching Claude's mcp-remote convention.

  3. Restart Claude

    Fully quit Claude Desktop (Cmd+Q on Mac) and reopen it. Reloading the window is not enough.

  4. Test the connection

    In a new chat, ask: "Call health_check on grademypage." You should see a JSON response with status: ok.

Connect ChatGPT

ChatGPT custom MCP connectors also favor OAuth over static API keys. If your ChatGPT workspace offers an API key field when adding a connector, you can try the steps below. Otherwise, wait for OAuth support or use Claude Desktop with the config above.

  1. Enable Developer mode

    In ChatGPT, open Settings. Under Apps & connectors (or Connectors), turn on Developer mode.

  2. Add a custom connector

    Click Create or Add connector and fill in:

    • Name: Grademypage
    • MCP server URL: https://grademypage.com/api/mcp
    • Authentication: API key, if the form offers it

  3. Start a new chat

    Open a new conversation, enable the Grademypage connector for that chat, and try: "Use Grademypage to list my projects."

Plan limits in ChatGPT
On Plus and Pro, custom MCP connectors may be read-only. Business, Enterprise, and Edu workspaces can use write-capable connectors when those tools are available. Grademypage v1 tools are read-only either way.

Available tools

ToolDescription
health_checkVerify connection and auth
list_projectsList audited URLs
get_latest_scanScores and top issues for a URL
get_scan_reportFull audit report by scan ID
get_project_overviewAudit, analytics, domain, and leads snapshot
get_analytics_snapshotTraffic, bounce rate, and top pages
get_domain_profileBacklinks and domain grade (Pro/Max)
get_leads_summaryReddit lead opportunities for a URL
get_lead_detailOne Reddit thread with suggested replies
get_experiment_summaryA/B experiment list or variant stats

Rate limits

MCP tool calls are limited per calendar day (UTC). health_check does not count toward your limit.

  • Free: 50 calls per day
  • Pro: 500 calls per day
  • Max: unlimited

Example prompts

  • "Using Grademypage, list my projects and summarize the latest audit for my main URL."
  • "Get my project overview for https://example.com and list critical landing page issues."
  • "Show top Reddit leads for example.com with intent score above 70."