Skip to content

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

ToolDescription
web_searchMulti-engine web search
web_extractExtract content from URLs
web_crawlCrawl website
web_researchDeep multi-source research
web_suggestSearch suggestions
web_imagesImage search
web_positionSEO position in Google
web_whoisDomain WHOIS lookup
web_dnsDNS resolution
web_cmsCMS detection
web_safebrowsingGoogle Safe Browsing
web_screenshotWebsite screenshot
web_redditReddit search
web_amazonAmazon product search
web_mapsGoogle Maps search
+180 more toolsFinance, 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}'