# mctelnet

MCP server providing telnet client capabilities for LLMs. Connect to BBSes, MUDs, network devices, and any telnet-accessible system.

## Installation

```bash
uvx mctelnet
```

Or add to Claude Code:

```bash
claude mcp add mctelnet "uvx mctelnet"
```

## Features

- **Multi-connection management** - Handle multiple simultaneous telnet sessions
- **Expect-style automation** - Pattern matching for interactive prompts
- **Script execution** - Run complete login/automation sequences
- **Password hiding** - Redact sensitive data from outputs

## Tools

| Tool | Description |
|------|-------------|
| `connect` | Establish telnet connection, returns connection ID |
| `send` | Send text to connection (auto-reads response) |
| `read` | Read available data from connection |
| `expect` | Wait for one of multiple patterns |
| `expect_send` | Wait for pattern, then send text |
| `run_script` | Execute expect-style automation script |
| `list_connections` | Show all active connections |
| `disconnect` | Close a connection |
| `disconnect_all` | Close all connections |

## Usage Examples

### Basic Interaction

```python
# Connect to a server
conn = await connect("bbs.example.com", 23)
# conn returns {"id": "abc123", ...}

# Send a command
await send("abc123", "help")

# Disconnect
await disconnect("abc123")
```

### Expect-Style Login

```python
# Connect and wait for login prompt
conn = await connect("server.example.com", 23)

# Handle login sequence
await expect_send(conn_id, "login:", "myuser")
await expect_send(conn_id, "Password:", "mypass", hide_send=True)
await expect_send(conn_id, "$ ", "ls -la")
```

### Scripted Automation

```python
await run_script(conn_id, [
    {"expect": "login:", "send": "admin"},
    {"expect": "Password:", "send": "secret", "hide": True},
    {"expect": "$ ", "send": "show version"},
    {"expect": "$ ", "send": "show interfaces"},
    {"expect": "$ ", "send": "exit"}
])
```

## Use Cases

- Connecting to retro BBSes and MUDs
- Network device configuration (routers, switches)
- Legacy system automation
- Interactive service testing
- Terminal-based game playing

## License

MIT