Anahita MCP

Anahita's docs and API reference for AI agents: an MCP server that runs on your computer.

Anahita is open-source social software that an organisation runs for its own community: people, groups, events, articles, photos, videos and custom feeds, in a chronological feed with no tracking. It speaks ActivityPub (the fediverse) and the AT Protocol (Bluesky).

Add this server to Claude, Cursor, VS Code or any other MCP client, and your agent can answer from the docs as they are today, not from what it remembers: how to set up a site, how federation works, which route follows a profile and what it answers.

• Runs on your computer. Your client starts it, and there is no account to make. Or add the hosted copy at https://mcp.anahita.io/mcp, with nothing to install.

• Reads, and only reads. Six tools, none of which changes anything.

• Sends nothing. It fetches two files from www.anahita.io, keeps them on your computer, and searches them there. Your questions never leave your machine through it. The hosted copy keeps nothing of them either.

• Works offline with what it fetched last.

Setting it up

With nothing to install

Anahita runs a copy at https://mcp.anahita.io/mcp (MCP's Streamable HTTP), in Montreal. It keeps no record of the questions or of who asked.

On your computer

You need Node.js 20 or later. Your client runs the server with npx, which fetches it from npm the first time.

Claude Code

claude mcp add anahita -- npx -y anahita-mcp

Claude Desktop

In Settings › Developer › Edit Config, add it to claude_desktop_config.json, then restart Claude:

{
  "mcpServers": {
    "anahita": {
      "command": "npx",
      "args": ["-y", "anahita-mcp"]
    }
  }
}

Cursor

In ~/.cursor/mcp.json, or .cursor/mcp.json in a project:

{
  "mcpServers": {
    "anahita": {
      "command": "npx",
      "args": ["-y", "anahita-mcp"]
    }
  }
}

VS Code

In .vscode/mcp.json in a project, or with MCP: Add Server from the command palette:

{
  "servers": {
    "anahita": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "anahita-mcp"]
    }
  }
}

Any other client

The server speaks MCP over standard input and output. The command is npx -y anahita-mcp. To run what is on main before it is published, npx -y github:anahitasocial/anahita-mcp.

Then ask your agent something like "How does Anahita decide what an old post is worth?" or "Which API route lets a person follow a group, and what does it send back?"

Related MCP server: Hermes Docs MCP Server

The tools

source is services for Anahita Services, the Go services and their API, or web for Anahita Web, the web app. A page is named by both, services/the-graph; services alone is its overview. Every answer gives the www.anahita.io address of what it read.

What it reads

The website writes them on every change to it and every night, from the docs of both repositories as they are on main, so they are a day behind at most. The server fetches them when a tool first needs them, and again an hour later only if they have changed. The copies are kept in the cache folder of your system: ~/Library/Caches/anahita-mcp on macOS, ~/.cache/anahita-mcp on Linux, %LOCALAPPDATA%\anahita-mcp\Cache on Windows. Search is by words, in the server, with no embeddings and no outside service.

Settings

Hosting your own

npx -y anahita-mcp --http answers over HTTP at /mcp instead, for a copy people add by its address with nothing to install. Hosting it says how, on any server or on AWS Lambda with deploy/.

Working on it

Changing the code, as a person or with an agent: begin with AGENTS.md, the project's working rules.

npm install
npm test      # builds, then runs the tests in test/
npm run build # dist/

TypeScript, on the official MCP TypeScript SDK.

To try it against the docs as you write them, build anahita.io (yarn build), serve its out/ folder, and set ANAHITA_SITE to where it is served. The tests use a few real pages and routes, in test/fixtures/.

Security

To report a vulnerability, see SECURITY.md. Please don't open a public issue.

Licence

MIT. Anahita Services is under the GNU AGPL-3.0 and Anahita Web under MIT: see Licensing.

Copyright © 2026 Rastin Mehr Design Studio Inc. (rmd studio). Anahita is a registered trademark of Rastin Mehr Design Studio Inc. in Canada.

Credits

Anahita is developed and maintained by rmd studio, a software development company in Vancouver, Canada. Founder and core architect: Rastin Mehr.