TheAlmanac
Enables programmers to search, download, and access up-to-date API and software documentation through MCP tools, integrating with LLMs like Claude for Desktop.
Caution. Specific findings reduced this grade. They are listed on the page. Grades reflect the full trust pyramid: code, verification depth, and reputation. New projects cap at C until adoption is earned.
How we verified
Verified is a snapshot. Live keeps it current, and builds your track record.
⚡ Connect GitHub → continuous verification on every pushwhy connect →Who stands behind it
SaharCarmel
Source: Glama
Claim it to get a verified publisher badge, a free copy of our full audit findings, and direct contact for any high-priority issues we find. Or connect your repo for our deepest verification, Live Monitored: read-only, revoke anytime. What we access →
Install from
The grade above is for the source repository. Registries can serve a different version, so we mark the ones we were not able to read.
These names and descriptions are the publisher's own, read from the source code. We print them as written. Our assessment is the findings above, not this list.
search_documentationSearch documentation for relevant information. Args: query: The search query source_name: Optional name of the documentation source to search (omit to search all) max_results: Maximum number of results to return (default: 5) Returns: Relevant documentation that matches the search query
get_documentationGet specific documentation content. Args: source_name: Name of the documentation source document_name: Name of the document (e.g., 'index.md') heading: Optional heading to retrieve a specific section Returns: The requested documentation content
download_documentationStart downloading documentation from a URL (async). Args: source_name: Name to identify the documentation source url: URL of the documentation website Returns: Task ID to track the download progress
get_task_statusGet the status of an asynchronous task. Args: task_id: The ID of the task to check Returns: Status information for the task
list_documentationList available documentation sources or documents. Args: source_name: Optional name of the documentation source to list documents for Returns: List of available sources or documents
ALMANAC_DOCS_DIRTool annotations
No tools have read-only/destructive annotations
Add readOnlyHint or destructiveHint annotations to every tool so hosts can warn users before invoking.
All four hints declared on every tool
7/7 tools missing one or more hints — search_documentation (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_documentation (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); download_documentation (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint), +4 more. OpenAI's directory rejects tools where any of the four hints are missing or non-boolean.
For every tool, set all four hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) to explicit true/false values that match the handler’s actual behaviour.
Descriptions match behaviour
1 tool describes read intent but its handler mutates — get_task_status (line 275: result_dict = eval(result.content))
Rename the tool, rewrite the description, or move the side-effect into a separate clearly-named tool.
Tool test coverage
4/7 tools referenced in tests (57%)
Write tests that reference each tool by name so every tool has at least one test.
Tool description accuracy
get_task_status: description implies read-only but handler writes/deletes/executes
Update tool descriptions to accurately reflect all capabilities — especially write, delete, or execute operations.
Claim the listing to review these findings one by one and send us a correction where you disagree, straight to the team. Claiming also means we tell you when the grade moves, and reach you first if we find anything urgent.
[](https://m8ven.ai/mcp/saharcarmel/thealmanac)?variant=verified from the URL.Vetting this one by hand? Tool Check is an MCP that scores other MCPs. Add it once and ask Claude, ChatGPT, or any MCP client to grade a server, surface CVEs, check the publisher, and suggest safer alternatives — before you install.
https://m8ven.ai/api/mcp/tool-check