Use Without an API Key

Web Data

You can connect Geonode MCP to your AI assistant and start extracting web pages without creating an account or adding an API key.

Point your MCP client at the Geonode endpoint, and your assistant can use the extract tool right away. This path is ideal for trying the service and for small jobs. When you need more capacity or more tools, add an API key to the same configuration.

What this guide covers

  • How to connect without an API key
  • What works in anonymous mode
  • Free rate and volume limits
  • How to upgrade to authenticated access

MCP Endpoint

Configure your MCP client with this endpoint:

https://mcp.geonode.com/mcp

The server uses MCP over streamable HTTP.

To confirm the endpoint is reachable, run:

curl https://mcp.geonode.com/mcp/health

A healthy response looks like this:

{"status":"ok","transport":"streamable-http","endpoint":"/mcp"}

Older setups

Set up earlier with scraper.geonode.io/mcp? It still works, no change needed.


Connect Your Client

You do not need a key, token, or custom header for anonymous access. If your client asks for authentication, leave it empty.

Claude Code

claude mcp add --transport http geonode https://mcp.geonode.com/mcp

Cursor, Claude Desktop, and other JSON-based clients

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

After you save the configuration, restart your client if required, then open a new chat and ask your assistant to extract a page.


What You Can Do Without a Key

Without an API key, only extract runs. It fetches a URL and returns the page content. It is synchronous only, with no JavaScript rendering and no custom headers except Accept-Language.

Your client may still list other tools. Calling them without a key returns an error that asks for an API key and includes a signup link.

You can ask your assistant something like:

Extract the content from https://example.com

Behind the scenes, the assistant calls extract on that URL.

Anonymous access is intentionally limited compared with a keyed connection:

CapabilityWithout a keyWith an API key
Tools that runextract onlyextract, map, search, crawl, batch, and job management
ModeSynchronous onlySynchronous and asynchronous jobs
JavaScript renderingNot availableAvailable with render_js
Custom headersAccept-Language onlyAny headers you need
Country selectionNot availableAvailable

If you request a feature that anonymous access does not support, the server returns a clear message about which limit applied, instead of failing silently.


Free Limits

Anonymous use is rate limited per client address. These limits may change.

LimitValue
Requests5 per minute
Concurrency1 request at a time
Fetched trafficAbout 100 MB per day

Fetched traffic is the traffic used to fetch pages, not the size of the content returned. The daily allowance resets at 00:00 UTC.

Hosted assistants such as Claude.ai or ChatGPT often send many users from shared addresses, so the free allowance may already be in use there.

If a keyless call hits a limit or asks for a key, add an API key rather than retrying the same keyless request.

Anonymous traffic is metered but not billed. No payment method is required.

Refused requests are not billed

Requests that are refused are not billed, with or without an API key.


Upgrade to an API Key

When you need the full tool set, async jobs, JavaScript rendering, country targeting, or higher limits, create a Geonode account, get an API key, and add it to the same MCP configuration:

{
  "mcpServers": {
    "geonode": {
      "url": "https://mcp.geonode.com/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your Geonode API key.

As soon as the key is recognized, the available tools expand and your plan rate limits apply.

Then follow the setup guide for your client, such as Claude Code, Claude Desktop, or Cursor.


Next Steps

  1. Connect your client to https://mcp.geonode.com/mcp with no key.
  2. Ask your assistant to extract a public page.
  3. When you outgrow the free limits, add an API key and continue with Before You Start.

Was this page helpful?

On this page