AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
MCP verified MIT Self-run

Mcp Tool Catalog

mcp-shriramkv-mcp-tool-catalog · by shriramkv

Generate human-readable Markdown or HTML docs for any MCP server's tools.

↗ Repository
— No reviews yet
0 installs
16 views
0.0% view→install

Install

$ agentstack add mcp-shriramkv-mcp-tool-catalog

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/mcp-shriramkv-mcp-tool-catalog)

Reliability & compatibility

✓ Security review passed
0 installs to date
— no reviews yet
● 1mo ago

Declared compatibility

Claude CodeClaude DesktopCursorWindsurf

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.

How agent discovery & health will work →
Are you the author of Mcp Tool Catalog? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

mcp-tool-catalog

Generate human-readable docs for any MCP server's tools.

An MCP server exposes its tools programmatically through tools/list, but there is rarely a clean, human-friendly document describing what those tools do and what arguments they take. mcp-tool-catalog launches a server, performs the MCP handshake, reads its tool surface, and renders a tidy Markdown or HTML catalog: one section per tool, with a parameter table and descriptions.

Great for READMEs, onboarding, PR reviews, and keeping a living record of what an agent can actually do.

Part of the AAIF (Agentic AI Innovation Foundation) open-source toolset for the agentic AI ecosystem.

Highlights

  • Works with any stdio MCP server, not a specific implementation.
  • Markdown output with a table of contents and per-tool parameter tables.
  • Self-contained HTML output for sharing.
  • Standard library only. No pip dependencies, no markdown engine.

Install

pip install -e .

Requires Python 3.9 or newer.

Usage

Pass the command that launches your server after --:

mcp-tool-catalog -- mcp-mock-server --config examples/weather.json

Write HTML to a file:

mcp-tool-catalog --format html -o catalog.html -- mcp-mock-server

Write Markdown to a file:

mcp-tool-catalog -o TOOLS.md -- python my_server.py

Example output

For a server exposing a get_forecast tool, the Markdown looks like:

# weather-mock — tool catalog

**Server version:** 1.0.0
**Protocol:** 2025-06-18
**Tools:** 1

## `get_forecast`

Return a canned weather forecast for a city.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `city` | string | yes |  |

How it works

mcp-tool-catalog includes a minimal stdio JSON-RPC client. It sends initialize, the notifications/initialized acknowledgement, then tools/list, and renders the returned tool definitions. It never calls tools, so it is safe to run against servers with side effects.

Development

pip install -e .
pytest

Tip: mcp-mock-server (a companion project) is a convenient target for trying this out without a real backend.

License

MIT. See [LICENSE](LICENSE).

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet, be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Content & Media