ProtocolBox 📦

The Standard Library for the Agentic Web.
https://protocolbox.in

ProtocolBox is a collection of high-reliability MCP (Model Context Protocol) tools designed for AI Agents. It provides verified, token-efficient utilities that work out-of-the-box with Claude, Gemini, and other MCP-compliant agents.

🚀 Installation

pip install protocolbox

Initialize the configuration for your agent:

protocolbox init

🛠️ Tools

ProtocolBox currently exports 8 tools optimized for agent workflows:

⚡ Usage

Start the MCP server to expose these tools to your agent:

protocolbox start

Or using uv:

uv run protocolbox start

📦 Project Structure

protocolbox/
├── src/protocolbox/      # Core package
│   ├── server.py         # FastMCP server
│   ├── cli.py            # CLI entry point
│   └── tools/            # Tool implementations
│       ├── scraper.py    # scrape()
│       ├── json_healer.py# heal_json()
│       ├── search.py     # web_search()
│       ├── math_utils.py # safe_math()
│       ├── time_utils.py # get_time()
│       ├── youtube.py    # get_transcript()
│       └── memory.py     # remember() + recall()
├── tests/                # 280+ edge-case tests
├── docs/                 # Documentation site
└── pyproject.toml        # Project config

👨‍💻 Development

We recommend uv for a fast, reliable dev environment.

# Clone and setup
git clone https://github.com/ianuragbhatt/protocolbox.git
cd protocolbox
uv pip install -e ".[dev]"

# Run tests (100% pass rate required)
pytest tests/ -v

# Linting
ruff check .

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for details on how to add new tools.

Maintainer: Anurag Bhatt (@ianuragbhatt)

License

MIT © 2026 ProtocolBox.