Ao3 MCP Server

by arturlysio.github.ArturLys/ao3-mcpv0.1.2

Search Archive of Our Own (AO3) and delegate full-fic reading to Gemini, so recommendations draw on the actual text rather than the blurb.

1Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained2mo ago

Install Ao3 MCP server

claude mcp add ao3 -e GEMINI_API_KEY='<gemini-api-key>' -- uvx ao3-mcp

{
  "mcpServers": {
    "ao3": {
      "command": "uvx",
      "args": [
        "ao3-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "ao3": {
      "command": "uvx",
      "args": [
        "ao3-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>"
      }
    }
  }
}

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

{
  "servers": {
    "ao3": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ao3-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "ao3": {
      "command": "uvx",
      "args": [
        "ao3-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
GEMINI_API_KEY	yes	yes	Gemini API key (free from https://aistudio.google.com/api-keys)

Freshness

Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-28 · 2mo ago · GitHub
Latest release
2026-07-28 · 2mo ago · GitHub · v0.1.2
Package published
no data · npm/PyPI
Registry entry updated
2026-07-28 · 2mo ago · official registry · v0.1.2

FAQ

›How do I install the Ao3 MCP server in Claude Code?

Run: claude mcp add ao3 -e GEMINI_API_KEY='<gemini-api-key>' -- uvx ao3-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Ao3 require an API key?

Yes. It expects GEMINI_API_KEY, of which 1 is a secret.

›Can I use Ao3 as a remote (hosted) MCP server?

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

›Is Ao3 in the official MCP registry?

Yes, as io.github.ArturLys/ao3-mcp.