TinyFish Guided Research MCP Server

by mohdsalehio.github.MohdSaleh/tinyfish-guided-researchv1.0.0

Auditable deep-research MCP server powered by TinyFish Search and Fetch.

0Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active25d ago

Install TinyFish Guided Research MCP server

claude mcp add tinyfish-guided-research -e TINYFISH_API_KEY='<tinyfish-api-key>' -e DATABASE_URL='<database-url>' -- uvx tinyfish-guided-research-mcp

{
  "mcpServers": {
    "tinyfish-guided-research": {
      "command": "uvx",
      "args": [
        "tinyfish-guided-research-mcp"
      ],
      "env": {
        "TINYFISH_API_KEY": "<tinyfish-api-key>",
        "DATABASE_URL": "<database-url>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "tinyfish-guided-research": {
      "command": "uvx",
      "args": [
        "tinyfish-guided-research-mcp"
      ],
      "env": {
        "TINYFISH_API_KEY": "<tinyfish-api-key>",
        "DATABASE_URL": "<database-url>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "tinyfish-guided-research": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tinyfish-guided-research-mcp"
      ],
      "env": {
        "TINYFISH_API_KEY": "<tinyfish-api-key>",
        "DATABASE_URL": "<database-url>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "tinyfish-guided-research": {
      "command": "uvx",
      "args": [
        "tinyfish-guided-research-mcp"
      ],
      "env": {
        "TINYFISH_API_KEY": "<tinyfish-api-key>",
        "DATABASE_URL": "<database-url>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
TINYFISH_API_KEY	yes	yes	TinyFish API key used by Search and Fetch.
DATABASE_URL	—	yes	Shared PostgreSQL connection URL for durable production state. Recommended for remote/multi-replica hosting.
RESEARCH_DB_PATH	—	—	SQLite persistence path used when DATABASE_URL is unset. Intended for local/single-instance usage.

Freshness

Active — last maintenance signal 25d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-15 · 25d ago · GitHub
Latest release
2026-09-15 · 25d ago · GitHub · v1.0.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-15 · 25d ago · official registry · v1.0.0

FAQ

›How do I install the TinyFish Guided Research MCP server in Claude Code?

Run: claude mcp add tinyfish-guided-research -e TINYFISH_API_KEY='<tinyfish-api-key>' -e DATABASE_URL='<database-url>' -- uvx tinyfish-guided-research-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does TinyFish Guided Research require an API key?

Yes. It expects TINYFISH_API_KEY, DATABASE_URL, of which 2 are secrets.

›Can I use TinyFish Guided Research as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is TinyFish Guided Research in the official MCP registry?

Yes, as io.github.MohdSaleh/tinyfish-guided-research.