Skip to main content
Glama
deenesjakoruzh
veer-mehta

fathom-mcp

by veer-mehta
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

fathom-mcp

Documentation RAG system: crawl a docs site → chunk + embed locally (HuggingFace) → store in Postgres+pgvector → semantic search via MCP server, REST API, and web UI.

Demo

live at https://fathom-mcp.veermehta.dev

Related MCP server: MCPDocSearch

Architecture

flowchart LR
    A[Browser] --> B[API Server]
    B --> D[Web UI]
    B --> C[(Postgres + pgvector)]
    B --> G[Ingestion Pipeline]
    G --> H[Scraper Subprocess]
    G --> C
    I[AI Client<br/>Claude Code, OpenCode] -->|MCP over stdio| F[MCP Server]
    F --> C

Quick start

git clone ... fathom-mcp && cd fathom-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e ".[local]"
docker compose up -d
cp .env.example .env              # set LLM_API_KEY
.venv/bin/docs-mcp-api            # http://127.0.0.1:8000

npm (no clone needed)

npx @fathom-mcp/server            # first run installs ~5GB deps, then instant
npx @fathom-mcp/server --api      # REST API + web UI

MCP tools

add_documentation · search_documentation · list_sources · get_ingest_status · add_local_docs

REST API

Endpoint

What

GET /search?q=...

Semantic search

GET /sources

Indexed sources

POST /upload

Upload files

POST /upload-folder

Index a local folder

GET /llm-chat?q=...

Chat with docs

GET /about

System info

OpenCode

Add to ~/.config/opencode/opencode.jsonc:

{
  "mcp": {
    "fathom-mcp": {
      "type": "local",
      "command": ["/path/to/fathom-mcp/.venv/bin/python", "-m", "docs_mcp.server"]
    }
  }
}

Replace /path/to/fathom-mcp with your actual clone path. You can verify it works with:

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | /path/to/fathom-mcp/.venv/bin/python -m docs_mcp.server

Config

~/.fathom-mcp/.env — set EMBEDDING_PROVIDER=api + EMBEDDING_API_KEY for remote embeddings (Jina, OpenAI, etc.), or leave as local for HuggingFace.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
A
license - permissive license
Not graded
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • AgentBase

    Shared knowledge base for AI agents. Semantic search across agents, no setup required — just a URL.

  • agentbay-mcp

    Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.

  • writespace-mcp

    Persistent docs and memory for AI agents — read, write, organize & search a shared workspace.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/veer-mehta/fathom-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server