Geonode logo

Connect your AI assistant to the live web

Use Geonode MCP from your editor or chat. Start with a page extraction, then add an API key for the full tool set.

Connect MCPRead documentation

What You'll Need

  • An MCP client

    Use a supported assistant or IDE with an MCP connection.

  • API key — optional to try

    Anonymous mode offers limited extract. Add a key for full access.

Try without an API key

For JSON-based clients such as Cursor. Follow your client’s setup guide, then ask it to extract a public page.

{
  "mcpServers": {
    "geonode": {
      "url": "https://mcp.geonode.com/mcp"
    }
  }
}

Choose your access level

Keep the same endpoint when moving from a trial call to authenticated workflows.

  • Anonymous extraction

    Anonymous limits apply per network address.

    extract only
5 requests / minute
1 concurrent request
100 MB / day

  • Full tool access

    Add your API key for more tools and plan limits.

    "headers": {
  "X-Api-Key": "YOUR_API_KEY"
}

  • Client-specific setup

    Follow the guide for Cursor, Claude Code, VS Code and other supported clients.

    https://mcp.geonode.com/mcp

From a prompt to a workflow

Extract https://example.com as Markdown.
Summarize the main points and keep the source URL.

Troubleshooting

  • Server not visible

    Save the client configuration and reconnect.

  • Only extract is listed

    This is expected without a recognized API key.

  • Authentication failed

    Check X-Api-Key in the client configuration.

  • Anonymous limit reached

    Wait for limits to reset or add an API key.

Build a dependable workflow

  • Try a single page

    Verify the connection with a small extract.

  • Name the source

    Give the assistant a URL and clear output.

  • Inspect tool calls

    Review arguments and returned content in your client.

  • Upgrade in place

    Add a key to the same MCP endpoint.

FAQ

Yes. Anonymous access provides limited synchronous extract; it does not include the full tool set. Anonymous use is limited to 5 requests per minute, 1 concurrent request and 100 MB of content per day.

Your assistant gets the full tool set, including crawl, batch, map, search and job management. Async jobs, JavaScript rendering, country targeting and your plan limits also become available.

Always use https://mcp.geonode.com/mcp. The same endpoint works with and without an API key; other hostnames are not supported for public use.

The MCP section of the Geonode documentation has step-by-step guides for Claude Code, Claude Desktop, Cursor, Visual Studio Code, Codex, Docker and other supported clients.

Let your assistant collect the sources.

Try a page without a key, then add full access when needed.

Connect MCPRead documentation