MCP server
Connect Claude, Cursor, or any MCP-capable AI client to Chuger's web extraction tools.
Chuger ships a first-class Model Context Protocol server on every plan. Once connected, your AI client can scrape pages, extract clean markdown, search the web, map sites, and check your credit balance — as native tools, with no glue code.
https://api.chuger.com/mcp/chuger
The server uses the streamable HTTP transport and authenticates with the same Bearer API token as the REST API (see Authentication).
Fastest setup: paste a prompt
Copy the agent install prompt, replace <CHUGER_API_TOKEN> with your token, and paste it into your AI chat. The agent detects its own client, adds the MCP server, installs the Chuger skill, and verifies the connection — no manual configuration.
Manual setup
claude mcp add --transport http chuger https://api.chuger.com/mcp/chuger \
--header "Authorization: Bearer YOUR_API_TOKEN"
{
"mcpServers": {
"chuger": {
"type": "http",
"url": "https://api.chuger.com/mcp/chuger",
"headers": { "Authorization": "Bearer YOUR_API_TOKEN" }
}
}
}
{
"mcpServers": {
"chuger": {
"type": "http",
"url": "https://api.chuger.com/mcp/chuger",
"headers": { "Authorization": "Bearer ${CHUGER_API_TOKEN}" }
}
}
}
Claude Desktop config lives at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows). Cursor uses ~/.cursor/mcp.json, Windsurf ~/.windsurf/mcp.json.
Available tools
| Tool | What it does | Credits |
|---|---|---|
extract-content | Page → clean markdown (markdown-only by default) | 2 |
scrape-url | Raw HTML of a page | 1 |
search-web | Search engine results | 5 |
search-web-with-content | Search + page content in one call | 15 |
map-domain | Discover a site's URLs from its sitemaps | 3 |
bulk-extract-content | Async extraction of many URLs (email/webhook delivery) | 2 per URL |
prompt-with-context | LLM analysis of a page | 10 |
get-credit-balance | Current credit balance | free |
preview-cost | Cost preview for a planned operation | free |
check-affordability | Can the balance cover an operation? | free |
Credits, rate limits, and billing work exactly like the REST API — see Credits.
Built to save tokens
extract-contentreturns markdown only by default. Requestformats: ["html", "metadata"]only when you need them.- Content responses include an
estimated_tokensfield so agents can budget context before reading further. map-domainreturns a URL list without fetching any page content — map first, then extract only the pages you need.
Troubleshooting
| Symptom | Fix |
|---|---|
401 Unauthorized / connection fails | The Authorization header is missing or the token is invalid. Create a token under Settings → API Tokens. |
NO_ACTIVE_SUBSCRIPTION tool error | The account has no plan. Subscribe at chuger.com/pricing. |
Insufficient credits tool error | Your balance is too low — top up or wait for the monthly renewal. |