Metadata-Version: 2.4
Name: procontext
Version: 0.1.2
Summary: MCP server for accurate, up-to-date library documentation
License: MIT
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: aiosqlite<1.0.0,>=0.19.0
Requires-Dist: anyio<5.0.0,>=4.0.0
Requires-Dist: httpx<1.0.0,>=0.28.0
Requires-Dist: mcp<2.0.0,>=1.26.0
Requires-Dist: platformdirs<5.0.0,>=4.0.0
Requires-Dist: pydantic-settings<3.0.0,>=2.2.0
Requires-Dist: pydantic<3.0.0,>=2.5.0
Requires-Dist: pyjwt>=2.12.0
Requires-Dist: pyyaml<7.0.0,>=6.0.1
Requires-Dist: rapidfuzz<4.0.0,>=3.6.0
Requires-Dist: structlog<26.0.0,>=24.1.0
Requires-Dist: uvicorn<1.0.0,>=0.34.0
Description-Content-Type: text/markdown

# ProContext

**Documentation layer for AI coding agents**

[![License: MIT][license-badge]][license-url]
[![Website][website-badge]][website-url]
[![Python 3.12+][python-badge]][python-url]
[![Protocol][protocol-badge]][protocol-url]

Your AI coding agent generates broken code because it doesn't have current docs.

ProContext fixes that - verified library documentation, served on demand.

[2000+ libraries](https://procontexthq.github.io/) · Works with Claude Code, Cursor, Codex, VS Code (GitHub Copilot), Windsurf, and any MCP-compatible tool

[website-badge]: https://img.shields.io/badge/website-procontext.dev-22d3ee.svg?textColor=black
[website-url]: https://procontext.dev
[license-badge]: https://img.shields.io/badge/License-MIT-green.svg
[license-url]: https://opensource.org/licenses/MIT
[python-badge]: https://img.shields.io/badge/python-3.12%2B-yellow.svg
[python-url]: https://www.python.org/downloads/
[protocol-badge]: https://img.shields.io/badge/protocol-MCP-blue.svg
[protocol-url]: https://modelcontextprotocol.io

---

## Why ProContext

| | Without ProContext | With ProContext |
| --- | --- | --- |
| **Discovery** | Agent guesses APIs from stale training data | Agent reads from a curated registry of 2000+ libraries |
| **Sources** | Web scraping and outdated search results | Hand-picked, verified documentation sources - no scraping, no noise |
| **Freshness** | Docs go stale as libraries update | Registry refreshes automatically in the background |
| **Speed** | Repeated fetches hit the network every time | Every page cached after the first fetch - millisecond lookups |
| **Context** | Entire docs dumped into context | Large pages served in paginated windows to respect token limits |
| **Precision** | Agent scrolls through irrelevant content | Search within a page or browse its outline to jump to the right section |
| **Safety** | Arbitrary URL access risks data leaks | Fetches restricted to known documentation domains |

## Quick Start

Install ProContext:

### macOS and Linux

```bash
curl -fsSL https://raw.githubusercontent.com/procontexthq/procontext/main/install.sh | bash
```

### Windows

Run this in a PowerShell terminal:

```powershell
irm https://raw.githubusercontent.com/procontexthq/procontext/main/install.ps1 | iex
```

Add ProContext to your MCP client config:

```json
{
  "mcpServers": {
    "procontext": {
      "command": "uv",
      "args": ["run", "--project", "/path/to/procontext-source", "procontext"]
    }
  }
}
```

The installer manages a local checkout and prints the path to use with `uv run --project ...`. For manual install, version pinning, and troubleshooting, see [docs/cli/installation.md](docs/cli/installation.md).

ProContext works with any MCP-compatible tool. The **[Integration Guide](docs/integration-guide.md)** has copy-paste configurations for Claude Code, Claude Desktop, Cursor, Windsurf, VS Code (GitHub Copilot), OpenAI Codex CLI, and Amazon Q CLI. Both stdio (local) and HTTP (shared/remote) transports are supported.

## Documentation

- [Integration guide](docs/integration-guide.md)
- [Installation guide](docs/cli/installation.md)
- [CLI docs](docs/cli/README.md)
- [API reference](docs/specs/04-api-reference.md)
- [Technical spec](docs/specs/02-technical-spec.md)
- [Project site](https://procontext.dev)

## Registry

The library registry is maintained in a separate repository: **[procontexthq/procontexthq.github.io](https://github.com/procontexthq/procontexthq.github.io)**

If you want to add a library or update an existing entry, open a PR there rather than in this repository.

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for contributor setup, development workflow, coding conventions, and pull request guidance.

## License

MIT - see [LICENSE](LICENSE) for details.

---

**Built with ❤️ for AI coding agents**