protocolbox 0.1.2

The Standard Library for the Agentic Web — verified MCP tools for any AI Agent.

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 3 core tools optimized for agent workflows:

Tool	Signature	Description
Scrape	scrape(url: str) -> str	Fetches a webpage and converts it to clean, token-saving Markdown. Removes ads, scripts, and clutter automatically.
Heal JSON	heal_json(json_str: str) -> dict	repairs malformed JSON strings often produced by LLMs (trailing commas, missing quotes, etc.) into valid Python dictionaries.
Invoice	generate_invoice(data: dict) -> str	Generates a professional PDF invoice from structured data in milliseconds.

⚡ 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
├── tests/                # 115+ 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.