Metadata-Version: 2.4
Name: mcprobe
Version: 0.1.0
Summary: Probe any MCP server from your terminal. List tools, inspect schemas, call endpoints.
Project-URL: Homepage, https://github.com/AlexlaGuardia/mcprobe
Project-URL: Repository, https://github.com/AlexlaGuardia/mcprobe
Project-URL: Issues, https://github.com/AlexlaGuardia/mcprobe/issues
Author-email: Alex LaGuardia <alex@guardiacontent.com>
License-Expression: MIT
License-File: LICENSE
Keywords: cli,debugging,inspector,mcp,model-context-protocol,probe
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Requires-Dist: httpx-sse>=0.4.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.9.0
Description-Content-Type: text/markdown

# mcprobe

You're building an MCP server. You want to see what tools it exposes, test a call, debug a schema. You don't want to wire up a full client just to do that.

`mcprobe` is the missing `curl` for MCP. Connect to any server, list its tools, call them, inspect schemas. From your terminal.

## Install

```bash
pip install mcprobe
```

## Usage

**List the tools on a server:**

```bash
mcprobe tools http://localhost:8100/sse
```

```
┌──────────────────────────────────────────────────┐
│  #  │ Tool              │ Description            │
├──────────────────────────────────────────────────┤
│  1  │ health            │ Full system status     │
│  2  │ query             │ Run SELECT queries     │
│  3  │ cortex_signal     │ Log observations       │
│ ... │                   │                        │
└──────────────────────────────────────────────────┘
70 tools available
```

**Inspect a tool's schema:**

```bash
mcprobe inspect http://localhost:8100/sse cortex_signal
```

**Call a tool:**

```bash
mcprobe call http://localhost:8100/sse health
mcprobe call http://localhost:8100/sse query -a '{"sql": "SELECT count(*) FROM clients"}'
```

**Check a server is alive:**

```bash
mcprobe ping http://localhost:8100/sse
```

## Commands

| Command   | What it does                          |
|-----------|---------------------------------------|
| `tools`   | List all tools (add `-v` for schemas) |
| `inspect` | Full schema for one tool              |
| `call`    | Call a tool with JSON args            |
| `ping`    | Check the server responds             |

## Transports

`mcprobe` auto-detects SSE (`/sse`) and streamable HTTP (`/mcp`) endpoints. No flags needed.

## Why

MCP servers are everywhere now. There was no quick way to look inside one without reading source or writing a client. This is that quick way.

## License

MIT
