Ferret — MCP Server Configuration
Ferret exposes a Model Context Protocol (MCP) server on port 9094 Compatible with Cursor, Claude Desktop, Claude Code, and OpenAI
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"ferret": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:9094/mcp"],
"env": {}
}
}
}
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"ferret-local": {
"command": "/home/mini/ferret/target/release/ferret",
"args": ["mcp", "--stdio"],
"env": {}
}
}
}
Claude Code
claude mcp add ferret --transport http http://localhost:9094/mcp
OpenAI (GPT-4.1)
from openai import OpenAI
client = OpenAI()
resp = client.responses.create(
model="gpt-4.1",
tools=[{
"type": "mcp",
"server_url": "http://localhost:9094/mcp",
}],
input="Search the web for AI news",
)
Remote Server
For remote access (e.g., Cursor on another machine):
{
"mcpServers": {
"ferret-remote": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://192.168.0.37:9094/mcp"],
"env": {}
}
}
}
Available MCP Tools
| Tool | Description |
|---|---|
web_search | Multi-engine web search |
web_extract | Extract content from URLs |
web_crawl | Crawl website |
web_research | Deep multi-source research |
web_suggest | Search suggestions |
web_images | Image search |
web_position | SEO position in Google |
web_whois | Domain WHOIS lookup |
web_dns | DNS resolution |
web_cms | CMS detection |
web_safebrowsing | Google Safe Browsing |
web_screenshot | Website screenshot |
web_reddit | Reddit search |
web_amazon | Amazon product search |
web_maps | Google Maps search |
| +180 more tools | Finance, crypto, French data… |
Verify It Works
curl http://localhost:9094/mcp -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"tools/list","id":1}'