@quercle/mcp
An MCP server for Quercle — AI-powered web search and fetch.
Gives Claude (and any MCP client) the ability to search the web and fetch + analyze pages.
Quick Start
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"quercle": {
"command": "npx",
"args": ["-y", "@quercle/mcp"],
"env": {
"QUERCLE_API_KEY": "qk_..."
}
}
}
}Restart Claude Desktop. You'll see the Quercle tools available in the chat.
Claude Code
claude mcp add --transport stdio --env QUERCLE_API_KEY=qk_... quercle -- npx -y @quercle/mcpGlobal Install (alternative)
npm install -g @quercle/mcpThen reference quercle-mcp instead of npx -y @quercle/mcp in your config.
Setup
Get your API key at quercle.dev and set it in the config as shown above.
Tools
The server exposes five tools:
search
Search the web and get an AI-synthesized answer with citations.
| Parameter | Required | Description |
|---|---|---|
query | Yes | The search query |
allowedDomains | No | Only return results from these domains |
blockedDomains | No | Exclude results from these domains |
fetch
Fetch a URL and analyze its content with AI.
| Parameter | Required | Description |
|---|---|---|
url | Yes | The URL to fetch |
prompt | Yes | Instructions for how to analyze the page content |
raw_search
Search the web and get raw results (without AI synthesis).
| Parameter | Required | Description |
|---|---|---|
query | Yes | The search query |
format | No | Response format: markdown (default) or json |
useSafeguard | No | Enable content safeguards (boolean) |
raw_fetch
Fetch raw content from a URL without AI processing.
| Parameter | Required | Description |
|---|---|---|
url | Yes | The URL to fetch |
format | No | Response format: markdown (default) or html |
useSafeguard | No | Enable content safeguards (boolean) |
extract
Extract relevant content from a URL based on a query.
| Parameter | Required | Description |
|---|---|---|
url | Yes | The URL to extract content from |
query | Yes | What to extract from the page |
format | No | Response format: markdown (default) or json |
useSafeguard | No | Enable content safeguards (boolean) |
Troubleshooting
| Issue | Solution |
|---|---|
| "Missing API key" | Set QUERCLE_API_KEY in the env section of your config |
| "Invalid API key" | Check your key starts with qk_ and is valid at quercle.dev |
| Timeout errors | The API may take up to 60s for complex queries — this is normal |
| Server not connecting | Run npx -y @quercle/mcp directly to check for errors |
License
MIT