About Protocolbox
Protocolbox is an MCP server published by ianuragbhatt in the Agents category: the Standard Library for the Agentic Web. A collection of verified, high-performance MCP tools designed to give AI Agents reliable superpowers.
The repository has 1 stars and 0 forks, with the last commit 8 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/ianuragbhatt/protocolboxThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (8)
**Get Time**`get_time(timezone: str) -> str`
Parameters not published.
**Get Transcript**`get_transcript(video_url: str) -> str`
Parameters not published.
**Heal JSON**`heal_json(json_str: str) -> dict`
Parameters not published.
**Recall**`recall(key: str) -> str`
Parameters not published.
**Remember**`remember(key: str, value: str) -> str`
Parameters not published.
**Safe Math**`safe_math(expression: str) -> str`
Parameters not published.
**Scrape**`scrape(url: str) -> str`
Parameters not published.
**Web Search**`web_search(query: str, max_results: int) -> str`
Parameters not published.
Ask AI
Ask AI about Protocolbox
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 4 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- !No dynamic code executionSource scan found eval or shell execution. Review how tool inputs reach it before granting credentials.
1 check has not been run yet.
Releases
README
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:
| 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. |
| Web Search | web_search(query: str, max_results: int) -> str |
Privacy-focused web search using DuckDuckGo. Returns formatted Markdown results. |
| Safe Math | safe_math(expression: str) -> str |
Securely evaluates mathematical expressions without eval(). Supports arithmetic and common math functions. |
| Get Time | get_time(timezone: str) -> str |
Returns the current real-world time in any timezone (ISO 8601 format). |
| Get Transcript | get_transcript(video_url: str) -> str |
Fetches the English transcript of a YouTube video as clean text. |
| Remember | remember(key: str, value: str) -> str |
Stores a key-value pair in persistent local memory. |
| Recall | recall(key: str) -> str |
Retrieves a value from persistent local memory by key. |
⚡ 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.
README fetched from the repository 4 days ago. The original is authoritative.