{"_id":"@baldaworks/mcpdump","name":"@baldaworks/mcpdump","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.1":{"bin":{"mcpdump":"mcpdump.js"},"description":"Meta package for mcpdump","engines":{"node":">=16"},"keywords":["ai","llm","mcp","agent","cli","dump"],"license":"MIT","name":"@baldaworks/mcpdump","optionalDependencies":{"@baldaworks/mcpdump-darwin-arm64":"1.0.1","@baldaworks/mcpdump-darwin-x64":"1.0.1","@baldaworks/mcpdump-linux-arm64":"1.0.1","@baldaworks/mcpdump-linux-x64":"1.0.1","@baldaworks/mcpdump-win32-x64":"1.0.1"},"repository":{"type":"git","url":"git+https://github.com/baldaworks/mcpdump.git"},"version":"1.0.1","gitHead":"bfd1482f9b43206414c7bda9a45a3de1ffc933d8","_id":"@baldaworks/mcpdump@1.0.1","bugs":{"url":"https://github.com/baldaworks/mcpdump/issues"},"homepage":"https://github.com/baldaworks/mcpdump#readme","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-TnRpxyMU9uxohSYEIXmHdRhh824uTmfGdggrt2qUVcu7ShKvDV7BMmsFyqTcewVNTQGGeWgOXIa20+VTeREbLg==","shasum":"a0dba0f25bf55295333a3423141408d7b5f12358","tarball":"https://registry.npmjs.org/@baldaworks/mcpdump/-/mcpdump-1.0.1.tgz","fileCount":4,"unpackedSize":7417,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGZ1Uao9IqM4bJ3Cv/oVDLfCbekwDbtxC8dRyYAOb/hyAiBrMD5zulqYmTGU/0YfnIFHhjKWFP8cTgJNU2e9CNGz6w=="}]},"_npmUser":{"name":"metalagman","email":"alexey.samoylov@gmail.com"},"directories":{},"maintainers":[{"name":"metalagman","email":"alexey.samoylov@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcpdump_1.0.1_1788262387691_0.1325371451688171"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-01T11:33:07.486Z","1.0.1":"2026-09-01T11:33:07.825Z","modified":"2026-09-01T11:33:08.146Z"},"maintainers":[{"name":"metalagman","email":"alexey.samoylov@gmail.com"}],"description":"Meta package for mcpdump","homepage":"https://github.com/baldaworks/mcpdump#readme","keywords":["ai","llm","mcp","agent","cli","dump"],"repository":{"type":"git","url":"git+https://github.com/baldaworks/mcpdump.git"},"bugs":{"url":"https://github.com/baldaworks/mcpdump/issues"},"license":"MIT","readme":"# mcpdump\n\n[![test](https://github.com/baldaworks/mcpdump/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/baldaworks/mcpdump/actions/workflows/test.yml)\n[![lint](https://github.com/baldaworks/mcpdump/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/baldaworks/mcpdump/actions/workflows/lint.yml)\n[![security](https://github.com/baldaworks/mcpdump/actions/workflows/security.yml/badge.svg?branch=main)](https://github.com/baldaworks/mcpdump/actions/workflows/security.yml)\n[![release](https://github.com/baldaworks/mcpdump/actions/workflows/omnidist-release.yml/badge.svg)](https://github.com/baldaworks/mcpdump/actions/workflows/omnidist-release.yml)\n[![npm](https://img.shields.io/npm/v/@baldaworks/mcpdump)](https://www.npmjs.com/package/@baldaworks/mcpdump)\n[![License](https://img.shields.io/github/license/baldaworks/mcpdump)](LICENSE)\n[![Version](https://img.shields.io/github/v/tag/baldaworks/mcpdump?label=version)](https://github.com/baldaworks/mcpdump/tags)\n\n**Inspect MCP servers before connecting tools or agents.**\n\n`mcpdump` starts any stdio Model Context Protocol (MCP) server command and\nprints initialize, capability, tool, prompt, resource, and resource-template\nmetadata.\n\nUse it when you need to confirm what an MCP server actually exposes before\nadding it to an agent, IDE, gateway, or automation workflow.\n\n## What You Get\n\n| Capability | Behavior |\n| --- | --- |\n| MCP preflight | Starts a stdio MCP server command and initializes a client session. |\n| Capability inventory | Prints protocol version, server info, and server capabilities. |\n| Tool discovery | Lists tools with input parameters and response schemas. |\n| Prompt/resource discovery | Shows prompts, resources, and resource templates when supported. |\n| JSON output | Emits machine-readable output for scripts, CI checks, and debugging artifacts. |\n| Quiet by default | Keeps inspector lifecycle logs out of the result unless `--debug` is enabled. |\n\n## Try It\n\nInstall globally:\n\n```sh\nnpm install -g @baldaworks/mcpdump@latest\n```\n\nRun once with `npx`:\n\n```sh\nnpx @baldaworks/mcpdump@latest -- <mcp-server-cmd> [args...]\n```\n\nInspect an MCP server:\n\n```sh\nmcpdump -- codex mcp-server\nmcpdump --json -- codex mcp-server --sandbox workspace-write\nmcpdump --debug -- <mcp-server-cmd> [args...]\n```\n\n## Provider Commands\n\n| Provider | Command |\n| --- | --- |\n| Codex MCP server | `mcpdump -- codex mcp-server` |\n| Codex with sandbox | `mcpdump --json -- codex mcp-server --sandbox workspace-write` |\n| Generic MCP | `mcpdump -- <mcp-server-cmd> [args...]` |\n\nThe `--` separator is required. Arguments before `--` are treated as\n`mcpdump` flags; arguments after it are passed to the MCP server command.\n\n## Output\n\nHuman-readable output includes:\n\n- server name and version\n- protocol version\n- server capabilities\n- tools with input parameters and response schemas\n- prompts, resources, and resource templates status\n\nUse `--json` when you want stable output for scripts, test fixtures, issue\nreports, or CI logs.\n\n## Use Cases\n\n- Verify an MCP server before registering it with an agent runtime.\n- Compare tool schemas across local and remote server commands.\n- Capture a compact diagnostic artifact for bug reports.\n- Check whether a local command is actually speaking MCP over stdio.\n\n## Flags\n\n| Flag | Purpose |\n| --- | --- |\n| `--json` | Print machine-readable JSON output. |\n| `--debug` | Enable debug logs for the inspector. |\n| `-h`, `--help` | Show command help. |\n\n## Repository\n\n- GitHub: <https://github.com/baldaworks/mcpdump>\n\n## Contact\n\n- Issues: <https://github.com/baldaworks/mcpdump/issues>\n- Maintainer: [@metalagman](https://github.com/metalagman)\n\n## License\n\nMIT. See the repository [LICENSE](https://github.com/baldaworks/mcpdump/blob/main/LICENSE).\n","readmeFilename":"README.md","_rev":"1-d57e962779d47b493ebeb0e16ded6305"}