mctelnet

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

Installation

uvx mctelnet

Or add to Claude Code:

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

# 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

# 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

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