neurynae avatar

Toolcairn Mcp

neurynae/toolcairn-mcp

Connects Claude to a graph of 30,000+ tools across npm, PyPI, Cargo, Maven, and 35+ registries. Exposes 16 tools for natural-language search with health signals, side-by-side comparison, version compatibility checks, and stack composition with cross-version matrices. Scans your project manifests on init, writes a local `.toolcairn/` snapshot, and lets the agent track what's already installed. The search flow handles ambiguous intents with clarifying questions via `search_tools_respond`. Every accepted or rejected recommendation feeds back into the graph through `report_outcome`. Useful when your agent needs to pick libraries, upgrade dependencies without breaking peer ranges, or build a coherent stack instead of guessing from stale tutorials.

GitHub stars
2
tools
16
transport
STDIO
last updated
May 1, 2026

Tools

16 tools

Public tool metadata for what this MCP can expose to an agent.

search_toolsNatural-language search with health signals and alternatives. May ask clarifying questions when intent is ambiguous.

Natural-language search with health signals and alternatives. May ask clarifying questions when intent is ambiguous.

No parameter schema in public metadata yet.

search_tools_respondSubmit answers to refine an in-progress search.

Submit answers to refine an in-progress search.

No parameter schema in public metadata yet.

refine_requirementDecompose a vague use-case ("build a SaaS") into specific, searchable sub-needs.

Decompose a vague use-case ("build a SaaS") into specific, searchable sub-needs.

No parameter schema in public metadata yet.

verify_suggestionCheck whether the agent's tool picks are actually indexed in the ToolCairn graph.

Check whether the agent's tool picks are actually indexed in the ToolCairn graph.

No parameter schema in public metadata yet.

get_stackCompose a complementary tool stack with a cross-version compatibility matrix.

Compose a complementary tool stack with a cross-version compatibility matrix.

No parameter schema in public metadata yet.

compare_toolsHead-to-head: health metrics, graph relationships, and a recommendation.

Head-to-head: health metrics, graph relationships, and a recommendation.

No parameter schema in public metadata yet.

check_compatibilityVersion-aware peer-range check between two tools.

Version-aware peer-range check between two tools.

No parameter schema in public metadata yet.

toolcairn_initDiscover project roots, scan manifests, classify tools, write .toolcairn/.

Discover project roots, scan manifests, classify tools, write .toolcairn/.

No parameter schema in public metadata yet.

read_project_configLoad the local .toolcairn/config.json snapshot (confirmed tools, pending items, audit log).

Load the local .toolcairn/config.json snapshot (confirmed tools, pending items, audit log).

No parameter schema in public metadata yet.

update_project_configAtomically add, remove, or update a tool — every mutation is audited.

Atomically add, remove, or update a tool — every mutation is audited.

No parameter schema in public metadata yet.

report_outcomeFire-and-forget: did the recommended tool work out? Closes the learning loop.

Fire-and-forget: did the recommended tool work out? Closes the learning loop.

No parameter schema in public metadata yet.

feedbackAgent feedback on ToolCairn itself. Call ONLY when a ToolCairn response was wrong, broken, low-quality, or missed something — never for positive feedback. Free of daily quota.

Agent feedback on ToolCairn itself. Call ONLY when a ToolCairn response was wrong, broken, low-quality, or missed something — never for positive feedback. Free of daily quota.

No parameter schema in public metadata yet.

suggest_graph_updateSubmit a new tool, edge, or use-case for admin review (staged, never auto-promoted).

Submit a new tool, edge, or use-case for admin review (staged, never auto-promoted).

No parameter schema in public metadata yet.

check_issueLast resort. Search a tool's GitHub issues for known bugs — only after 4+ retries and a docs review.

Last resort. Search a tool's GitHub issues for known bugs — only after 4+ retries and a docs review.

No parameter schema in public metadata yet.

classify_promptLocal: decide whether a tool search is needed at all (skips ToolCairn for non-tool prompts).

Local: decide whether a tool search is needed at all (skips ToolCairn for non-tool prompts).

No parameter schema in public metadata yet.

toolcairn_authManage local sign-in: login / status / logout.

Manage local sign-in: login / status / logout.

No parameter schema in public metadata yet.

Sponsors

Readme

Details

Repository
github.com/neurynae/toolcairn-mcp
Package
@neurynae/toolcairn-mcp
Transport
STDIO
Registry
MCP registry, active