Use Without an API Key
Web DataYou 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/mcpThe server uses MCP over streamable HTTP.
To confirm the endpoint is reachable, run:
curl https://mcp.geonode.com/mcp/healthA 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/mcpCursor, 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.comBehind the scenes, the assistant calls extract on that URL.
Anonymous access is intentionally limited compared with a keyed connection:
| Capability | Without a key | With an API key |
|---|---|---|
| Tools that run | extract only | extract, map, search, crawl, batch, and job management |
| Mode | Synchronous only | Synchronous and asynchronous jobs |
| JavaScript rendering | Not available | Available with render_js |
| Custom headers | Accept-Language only | Any headers you need |
| Country selection | Not available | Available |
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.
| Limit | Value |
|---|---|
| Requests | 5 per minute |
| Concurrency | 1 request at a time |
| Fetched traffic | About 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.
- Plans and pricing: geonode.com/pricing
- Full authenticated setup: Before You Start
Then follow the setup guide for your client, such as Claude Code, Claude Desktop, or Cursor.
Next Steps
- Connect your client to
https://mcp.geonode.com/mcpwith no key. - Ask your assistant to extract a public page.
- When you outgrow the free limits, add an API key and continue with Before You Start.
Was this page helpful?