Skip to main content

Sphinx extension that submits your docs to AgentReady after every build, making them instantly queryable by AI agents via MCP.

Project description

sphinx-agentready

Sphinx extension that submits your docs site to AgentReady after every build, making it instantly queryable by AI agents (Claude, Cursor, Windsurf, and any MCP client) with cited, multi-page answers.

Installation

pip install sphinx-agentready

Usage

Add the extension to your conf.py:

extensions = [
    "sphinx_agentready.extension",
]

# Domain is inferred from html_baseurl automatically, or set explicitly:
agentready_domain = "docs.yoursite.com"

After each sphinx-build or make html:

[AgentReady] ✓ Indexed docs.yoursite.com. AI agents can now query it.
[AgentReady]   MCP:  https://www.agentready.it.com/api/mcp

How it works

After your site builds, the extension posts your domain to AgentReady's indexing webhook. AgentReady crawls your docs and makes them queryable via:

  • MCP serverhttps://www.agentready.it.com/api/mcp (works in Claude, Cursor, Windsurf, and any MCP client)
  • REST endpointPOST https://www.agentready.it.com/api/sites/{id}/ask
  • llms.txthttps://www.agentready.it.com/api/sites/{id}/llms.txt

Connecting to your AI tools

Claude Code / Claude Desktop

claude mcp add agentready npx @agentreadyweb/mcp

VS Code (GitHub Copilot)

// .vscode/mcp.json
{
  "servers": {
    "agentready": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@agentreadyweb/mcp"]
    }
  }
}

Then ask your AI: "Ask agentready: how do I configure X in [your docs]?"

Configuration

Option Default Description
agentready_domain (inferred from html_baseurl) Domain of your docs site (e.g. docs.example.com)

License

MIT © AgentReady

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphinx_agentready-1.0.0.tar.gz (2.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sphinx_agentready-1.0.0-py3-none-any.whl (3.6 kB view details)

Uploaded Python 3

File details

Details for the file sphinx_agentready-1.0.0.tar.gz.

File metadata

  • Download URL: sphinx_agentready-1.0.0.tar.gz
  • Upload date:
  • Size: 2.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for sphinx_agentready-1.0.0.tar.gz
Algorithm Hash digest
SHA256 7c20018880be9a01d3d1024fda00c86d2b85e77d681df828694249f7c87f37e8
MD5 9fb27240748abd5d37fe681c13a2a25a
BLAKE2b-256 678498a2effa18359216596218fb4783c655e1569e726ff20111224f1ea9221a

See more details on using hashes here.

File details

Details for the file sphinx_agentready-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: sphinx_agentready-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 3.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for sphinx_agentready-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5b53305976d7810d39dbe8b97909f378a723555b430c51022e12d1aa6dc8665b
MD5 1e9fa57081029156e79d38fd3c9109ad
BLAKE2b-256 ef0b00847393c023ee7d847a08351e3f0a5ba7701359443cd798cf81c5177bfc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page