# Mcpplay

> The FastAPI /docs experience, for MCP servers.

- **Type:** MCP server
- **Install:** `agentstack add mcp-gauthierpiarrette-mcpplay`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [gauthierpiarrette](https://agentstack.voostack.com/s/gauthierpiarrette)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [gauthierpiarrette](https://github.com/gauthierpiarrette)
- **Source:** https://github.com/gauthierpiarrette/mcpplay
- **Website:** https://mcpplay.dev

## Install

```sh
agentstack add mcp-gauthierpiarrette-mcpplay
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

mcpplay

    The FastAPI /docs experience, for MCP servers.

    
    
    
    

  Documentation • Getting Started • Issues

  ⚡ Run your MCP server → instantly get an interactive UI.

https://github.com/user-attachments/assets/ecaa69d9-b441-44d8-b709-93b168398858

**mcpplay** gives you a browser-based playground for [MCP](https://modelcontextprotocol.io)-compliant servers. One command, and you get auto-generated forms, live results, and a full execution timeline.

Built for [FastMCP](https://github.com/jlowin/fastmcp) workflows. Works with any MCP-compliant implementation.

## Installation

```bash
pip install mcpplay
mcpplay demo
```

Your browser opens to `http://localhost:8321`. That's it!

  

### Point it at your own server

```bash
mcpplay run server.py
mcpplay run --command "node server.js"
mcpplay run --command "uvx my-mcp-server"
```

### Options

```bash
mcpplay run server.py --port 9000        # Custom port (default: 8321)
mcpplay run server.py --no-open          # Don't auto-open browser
mcpplay run server.py --no-reload        # Disable hot reload
mcpplay run server.py --env API_KEY=xxx  # Pass env vars to server
```

## Features

- **Schema-aware forms** - auto-generated from your tool's JSON Schema, with enums, nested objects, arrays, and defaults.
- **Live execution** - run tools and see structured results instantly.
- **Persistent timeline** - every call logged with inputs, outputs, and latency. Replay with one click.
- **Hot reload** - edit your server, mcpplay restarts it. Session and timeline preserved.
- **Local-first** - runs on localhost (`127.0.0.1`) with Origin validation. No remote exposure by default.

## Comparison

| | **mcpplay** | MCP Inspector | MCPJam Inspector |
|---|---|---|---|
| **Install** | `pip install` | `npx` (Node required) | Docker |
| **Python native** | ✅ | ❌ | ❌ |
| **Form generation** | Full JSON Schema | Basic inputs | Basic inputs |
| **Hot reload** | ✅ | ❌ | ❌ |
| **Execution timeline** | Persistent, replayable | Log | Log |

## Development

```bash
git clone https://github.com/gauthierpiarrette/mcpplay
cd mcpplay

# Python backend
uv sync --dev
uv run pytest

# Frontend (Svelte)
cd frontend
npm install
npm run dev      # Dev server with HMR
npm run build    # Build to src/mcpplay/static/
```

## License

Apache 2.0

## Source & license

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

- **Author:** [gauthierpiarrette](https://github.com/gauthierpiarrette)
- **Source:** [gauthierpiarrette/mcpplay](https://github.com/gauthierpiarrette/mcpplay)
- **License:** Apache-2.0
- **Homepage:** https://mcpplay.dev

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-gauthierpiarrette-mcpplay
- Seller: https://agentstack.voostack.com/s/gauthierpiarrette
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.