Open Source · MCP Compliant · Python 3.11+

Give your AI agent
reliable tools.

ProtocolBox is an open-source Python library of 8 verified MCP tools that let AI agents scrape the web, search, do math, fetch transcripts, and remember context — without hallucinating or wasting tokens.

$ pip install protocolbox

Tools

283

Tests

100%

Pass Rate

API Keys

Up and running in 60 seconds

Install the package, initialize the config for your agent, and start the MCP server.

Install

One command installs all 8 tools. No external API keys needed.

pip install protocolbox

Initialize

Generate the MCP config file for your AI agent (Claude, Cursor, etc.).

protocolbox init

Start

Launch the MCP server. Your agent can now call any tool instantly.

protocolbox start

Every tool your agent needs

Each tool is verified, edge-case tested, and designed to return clean, token-efficient output.

Web Tools

3 tools

scrape

(url: str) → str

Fetches a webpage and converts it to clean Markdown. Strips ads, scripts, navigation, and clutter — 90% token reduction.

web_search

(query: str, max_results: int) → str

Privacy-focused search via DuckDuckGo. Returns formatted Markdown with titles, links, and snippets. No API key.

get_transcript

(video_url: str) → str

Fetches the English transcript of any YouTube video as clean text. Supports standard, short, and embed URLs.

Logic & Data

2 tools

safe_math

(expression: str) → str

Securely evaluates math expressions using AST parsing — zero eval(). Supports arithmetic, sqrt, floor, ceil, sin, cos, tan, log.

heal_json

(broken_json: str) → dict

Repairs malformed JSON produced by LLMs. Fixes trailing commas, unquoted keys, single quotes, and truncated output.

Utilities

3 tools

get_time

(timezone: str) → str

Returns the current time in any timezone, formatted as ISO 8601. Supports 500+ timezones.

remember

(key: str, value: str) → str

Stores a key-value pair in persistent local memory. Data survives across sessions.

recall

(key: str) → str

Retrieves a value from persistent memory. Perfect for maintaining agent context across conversations.

Give your AI agentreliable tools.