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 server —
https://www.agentready.it.com/api/mcp(works in Claude, Cursor, Windsurf, and any MCP client) - REST endpoint —
POST https://www.agentready.it.com/api/sites/{id}/ask - llms.txt —
https://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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7c20018880be9a01d3d1024fda00c86d2b85e77d681df828694249f7c87f37e8
|
|
| MD5 |
9fb27240748abd5d37fe681c13a2a25a
|
|
| BLAKE2b-256 |
678498a2effa18359216596218fb4783c655e1569e726ff20111224f1ea9221a
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5b53305976d7810d39dbe8b97909f378a723555b430c51022e12d1aa6dc8665b
|
|
| MD5 |
1e9fa57081029156e79d38fd3c9109ad
|
|
| BLAKE2b-256 |
ef0b00847393c023ee7d847a08351e3f0a5ba7701359443cd798cf81c5177bfc
|