Ferret — MCP Server Configuration

Ferret exposes a Model Context Protocol (MCP) server on port 9094 with 121 tools, using the StreamableHTTP transport. 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 (local stdio transport):

{
  "mcpServers": {
    "ferret-local": {
      "command": "/home/mini/ferret/target/release/ferret",
      "args": ["mcp", "--stdio"],
      "env": {}
    }
  }
}

Or, if Ferret runs as a service on port 9094, use the remote transport:

{
  "mcpServers": {
    "ferret-remote": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:9094/mcp"],
      "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), point at the host running Ferret:

{
  "mcpServers": {
    "ferret-remote": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://192.168.0.37:9094/mcp"],
      "env": {}
    }
  }
}

Start the MCP server

# As a service (recommended)
systemctl --user start ferret-mcp.service    # port 9094

# Or directly
./target/release/ferret mcp --port 9094

Available MCP Tools (121)

The 121 tools are grouped by domain. The core web tools:

Tool	Description
`web_search`	Multi-engine web search (Bing, DDG, Brave, Google, Yahoo, AOL, Seznam, Qwant)
`web_extract`	Extract content from URLs
`web_crawl`	Crawl a website
`web_research`	Deep multi-source research (5 engines, dedup, summary)
`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 (1446 signatures)
`web_safebrowsing`	Google Safe Browsing
`web_screenshot`	Website screenshot
`web_reddit`	Reddit search
`web_amazon`	Amazon product search
`web_maps`	Google Maps search
+101 more tools	Finance, crypto, French data, weather, sports, travel, health, research…

The remaining 101 tools mirror the business endpoints and the 333 parsers — every parser has a corresponding MCP tool.

Verify it works

curl http://localhost:9094/mcp -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

The response lists all 121 tools with their schemas.

API Reference — the underlying REST endpoints
Business endpoints — cross-cutting analyses exposed as MCP tools
Quick Start — get the server running in 3 minutes