# Repl Mcp

> Interactive REPL for testing Model Context Protocol (MCP) servers

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

## Install

```sh
agentstack add mcp-kkokosa-repl-mcp
```

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

## About

# MCP REPL

[](https://pypi.org/project/repl-mcp/)
[](https://github.com/kkokosa/repl-mcp/blob/main/LICENSE)
[](https://pypi.org/project/repl-mcp/)

Interactive REPL for testing Model Context Protocol (MCP) servers.

Replated blog post: [https://kokosa.dev/blog/2026/repl-mcp/](https://kokosa.dev/blog/2026/repl-mcp/).

## Features

- List and inspect tools, prompts, and resources
- Call tools with JSON or interactive parameter input
- Tab autocompletion for commands and tool names
- Command history (arrow keys)
- Rich terminal UI with syntax highlighting

## Installation

### Option 1: Install from PyPI (Recommended)

```bash
# Using uv (fast, Rust-based)
uv tool install repl-mcp

# Using pipx
pipx install repl-mcp

# Using pip
pip install repl-mcp
```

### Option 2: Run directly without installing

```bash
# Using uvx
uvx repl-mcp -c "npx mcp-remote https://mcp.atlassian.com/v1/mcp"
```

### Option 3: Development Setup

```bash
git clone https://github.com/kkokosa/repl-mcp.git
cd repl-mcp
pip install -e .
```

## Usage

> [!NOTE] 
> `mcp-remote` sidenote - Some MCP servers (like Atlassian) use OAuth for authentication and don't support direct HTTP connections. The `mcp-remote` MCP bridges this gap by handling OAuth flows locally and/or converting HTTP-based MCP servers to stdio transport. Beware that for OAuth-based servers, `mcp-remote` needs to receive the OAuth callback. If you're running in an environment without a public URL (like WSL or a remote server), you'll need a tunneling tool like [ngrok](https://ngrok.com/) to expose the callback endpoint.

### Stdio Transport (command-based)

```bash
# Simple MCP server
repl-mcp -c "npx -y @modelcontextprotocol/server-filesystem /tmp"

# Remote MCP server via mcp-remote proxy (requires ngrok or similar for OAuth authorization!)
repl-mcp -c "npx mcp-remote https://mcp.atlassian.com/v1/mcp"

# Local Python MCP server
repl-mcp -c "python my_mcp_server.py"

# Using uvx
repl-mcp -c "uvx mcp-server-sqlite --db-path test.db"
```

### HTTP Transport (URL-based)

```bash
# GitHub Copilot MCP
repl-mcp -url https://api.githubcopilot.com/mcp/ \
         -H "Authorization: Bearer YOUR_GITHUB_TOKEN" \
         -t http

# Notion MCP
repl-mcp -u https://mcp.notion.com/mcp

# Multiple headers
repl-mcp -u https://example.com/mcp \
         -H "Authorization: Bearer TOKEN" \
         -H "X-Custom-Header: value"
```

### Using a config file

```bash
# If multiple servers in config, you'll be prompted to choose
repl-mcp --config sample-mcp-config.json

# Or select specific server directly
repl-mcp --config sample-mcp-config.json --server github
```

#### Config file formats

**Stdio transport:**

```json
{
  "command": "npx",
  "args": ["mcp-remote", "https://mcp.atlassian.com/v1/mcp"]
}
```

**HTTP transport:**

```json
{
  "url": "https://api.githubcopilot.com/mcp/",
  "headers": {
    "Authorization": "Bearer YOUR_TOKEN"
  }
}
```

**Multiple servers (Cursor/Claude Desktop format):**

```json
{
  "mcpServers": {
    "atlassian": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.atlassian.com/v1/mcp"]
    },
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    },
    "notion": {
      "url": "https://mcp.notion.com/mcp",
      "headers": {}
    }
  }
}
```

**YAML format:**

```yaml
command: npx
args:
  - mcp-remote
  - https://mcp.atlassian.com/v1/mcp
```

## REPL Commands

| Command | Description |
|---------|-------------|
| `tools` | List all available tools |
| `tool ` | Show detailed info about a specific tool |
| `prompts` | List all available prompts |
| `resources` | List all available resources |
| `call  [args]` | Call a tool (interactive input if no args) |
| `prompt  [args]` | Get a prompt with optional JSON arguments |
| `read ` | Read a resource by URI |
| `info` | Show server info and capabilities |
| `help` | Show help message |
| `quit` / `exit` / `q` | Exit the REPL |

### Keyboard Shortcuts

| Key | Action |
|-----|--------|
| `Tab` | Autocomplete commands and tool names |
| `↑` / `↓` | Navigate command history |
| `Ctrl+C` | Cancel current input |
| `Ctrl+D` | Exit REPL |

## Examples

```
mcp> tools
┌─────────────────────────────────────────────────────────┐
│ Available Tools (15)                                    │
├──────────────────┬───────────────────────────┬──────────┤
│ Name             │ Description               │ Params   │
├──────────────────┼───────────────────────────┼──────────┤
│ get_issue        │ Retrieves a Jira issue... │ issueKey │
│ search_issues    │ Search for issues using...│ jql      │
└──────────────────┴───────────────────────────┴──────────┘

mcp> call get_issue {"issueKey": "PROJ-123"}
┌─────────────────────────────────────────────────────────┐
│ Result                                                  │
├─────────────────────────────────────────────────────────┤
│ {                                                       │
│   "key": "PROJ-123",                                    │
│   "summary": "Example issue",                           │
│   ...                                                   │
│ }                                                       │
└─────────────────────────────────────────────────────────┘

mcp> quit
Goodbye!
```

## Requirements

- Python 3.10+
- Node.js (if using `npx mcp-remote`)

## Source & license

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

- **Author:** [kkokosa](https://github.com/kkokosa)
- **Source:** [kkokosa/repl-mcp](https://github.com/kkokosa/repl-mcp)
- **License:** MIT

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-kkokosa-repl-mcp
- Seller: https://agentstack.voostack.com/s/kkokosa
- 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%.