MCP Toolbox
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_TOOLBOX_DB | No | Path to the JSON file used for document store persistence. Defaults to ~/.mcp_toolbox/documents.json. | ~/.mcp_toolbox/documents.json |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| add_documentA | Store a new text document and return its generated id and metadata. Args: content: The document body text (required, non-empty). title: An optional short title. tags: Optional list of tag strings for filtering/boosting search. |
| search_documentsA | Keyword-search the stored documents and return ranked matches. Each result includes an id, title, relevance score, tags, and a snippet. Use get_document with a returned id to read the full text. Args: query: Words to search for. limit: Maximum number of results (default 5). |
| get_documentA | Fetch a single document's full content by its id. Args: document_id: The id returned by add_document or search_documents. |
| list_documentsA | List all stored documents (newest first) with their ids and titles. |
| web_searchA | Search the public web (DuckDuckGo, with a Wikipedia fallback). No API key. Returns a list of results, each with a title, url, and snippet. On network
failure it returns an Args: query: The search query. limit: Maximum number of results (1-10, default 5). |
| calculateA | Safely evaluate an arithmetic expression and return the numeric result. Supports + - * / // % ** parentheses, the constants pi/e/tau, and common math functions (sqrt, sin, cos, log, factorial, etc.). It does NOT use eval; expressions are parsed and evaluated against a strict whitelist. Args: expression: e.g. "2 + 2", "sqrt(144)", "(3.5 * 4) ** 2", "log(e)". |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: document search, document creation, document retrieval, document listing, web search, and calculation. Even search_documents and list_documents are well differentiated by query-driven search versus full listing.
Most tools follow a clear verb_noun pattern (add_document, get_document, list_documents, search_documents). web_search inverts that order and calculate uses only a verb, but the overall naming is still readable and predictable.
Six tools is a reasonable, focused size for a document management helper with optional web search and calculation utilities. Each tool contributes a distinct capability without redundancy or bloat.
The document lifecycle is incomplete: add, get, list, and search are covered, but there is no update or delete operation for stored documents, which is a notable gap for a document store. web_search and calculate are one-shot utilities and don't need additional operations.