MCP servers · arturlys

ao3-mcp: AO3 fanfiction search with text-based reading by a secondary model

An MCP server that lets AI agents search the Archive of Our Own, and has a secondary Gemini model read full fics before they are recommended.

This text was machine-translated from the publisher's own information and has not been checked by a human editor. The publisher's original text is the reference.

This resource was imported automatically from the sources listed below and has not been reviewed by the AI Gate team yet. The description is the publisher's own, as published. Check the repository before installing.

What it does

The server connects MCP clients such as Claude, Cursor or other agents to the Archive of Our Own (AO3). Its search_works tool supports filters and AO3's search-operator syntax, find_tags maps fuzzy wording to canonical tags, and get_work returns a metadata card for one work. read_works has a secondary Gemini model read 1 to 20 full fics and return a structured report for each, covering plot, characters, style, verbatim prose samples and content notes, plus a ranking against the user's question. The agent itself never reads the fic text, and fic downloads are cached locally for 24 hours.

It suits anyone who wants recommendations based on the actual text rather than the author's blurb. Writers can also use it for inspiration mid-scene, pulling reports on how other fics handle a similar beat, or for roleplay, using reports on fics with a strong character voice as style reference.

Running it requires Python 3.10 or later and a free Gemini API key, supplied as a launch argument or environment variable. Launch parameters set the reader model, a backup model and the minimum interval between AO3 requests, which defaults to 0.6 seconds. AO3 has no API, so the server scrapes its HTML one request at a time and honours Retry-After. The code is small and MIT-licensed, and the publisher intends it to be forked and modified.

Limitations and requirements

Requires Python 3.10 or later and a free Gemini API key. AO3 blocks plain HTTP clients; the server uses a browser TLS fingerprint, and if requests fail with 403 and a Cloudflare challenge, the IMPERSONATE setting in ao3.py must be changed. Fic text is sent to Google's Gemini API for reading. AO3 hosts works of all ratings, and the server passes through whatever the search returns, so the rating filter and AO3 warning tags should be used to control what is fetched.

Safety

Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.

  • Runs code or changes an assistant's behaviour

Sources

  • Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
    io.github.ArturLys/ao3-mcp

    Search AO3 and have fics read by a secondary model before they're recommended

    v0.1.2
    As shown on registry.modelcontextprotocol.io when we last read it
MCP servers
cloudflare

Cloudflare MCP servers

Cloudflare's hosted MCP servers for its products: documentation search, sandbox containers, browser rendering, Radar internet data, logs and analytics, Workers and more.

4.5K GitHub starsCloud & DevOpsSoftware development
Updated 18 Nov 2026
MCP servers
neondatabase

Neon MCP Server (Postgres)

Neon's MCP server for managing Neon Postgres in plain language: create projects and branches, run queries and prepare schema migrations from your editor.

663 GitHub starsData & databasesSoftware development
Updated 18 Nov 2026
MCP servers
microsoft

Playwright MCP (browser automation)

Microsoft's MCP server that lets an AI assistant open web pages, click, type and read them through a real browser, using the page structure instead of screenshots.

39.6K GitHub starsTesting & QAWeb, search & browser
Updated 18 Nov 2026
MCP servers
supabase-community

Supabase MCP Server

Supabase's MCP server that connects an AI assistant to your Supabase project to design tables, run queries, read configuration and look up documentation.

Data & databasesSoftware development
Updated 18 Nov 2026