About Poe MCP
Poe MCP is an MCP server published by n0madic in the AI category: poe-mcp is an MCP server that exposes Poe.com bots and the model catalog as MCP tools.
The repository has 2 stars and 0 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/n0madic/poe-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Poe MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 4 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
Poe-MCP
MCP (Model Context Protocol) server and CLI tool that exposes Poe bots and the model catalog. Use it as:
- MCP Server: Integrate with MCP-compatible clients (Claude Code, Cursor, etc.) to query bots and search models
- CLI Tool: Run directly from the terminal for quick bot queries and model searches
Usage
MCP Server Mode
Run poe-mcp without arguments to start the MCP server:
POE_API_KEY=<key> poe-mcp
Then configure your MCP client (see Configuration below).
MCP Tools
query_bot
Send a message to any Poe bot and get the full response. Supports file attachments.
| Parameter | Type | Required | Description |
|---|---|---|---|
bot |
string | yes | Bot name on Poe (e.g. GPT-4o, Claude-4.5-Sonnet) |
message |
string | yes | User message to send to the bot |
files |
array | no | Files to attach (local paths or URLs) |
temperature |
float | no | Sampling temperature (0.0–2.0) |
The files parameter accepts an array of strings — each string is either a local file path or a URL (auto-detected by http:///https:// prefix). Filename is extracted automatically.
Example: "files": ["/path/to/local.pdf", "https://example.com/image.jpg"]
search_models
Search and filter the Poe model catalog.
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | no | Case-insensitive substring match on ID, name, description, owner |
owned_by |
string | no | Filter by owner/provider (e.g. OpenAI, Anthropic) |
modality |
string | no | Filter by modality substring (e.g. text, image) |
CLI Mode
Run poe-mcp with subcommands for direct terminal access:
Search models (no API key required):
# Search all models
poe-mcp search "GPT-4o"
# Filter by owner
poe-mcp search --owner OpenAI
# Filter by modality
poe-mcp search --modality image
# Combine filters and query
poe-mcp search --owner Google --modality text "pro"
Query a bot (requires POE_API_KEY):
export POE_API_KEY=<key>
# Basic query
poe-mcp query GPT-4o "What is Go?"
# With temperature setting
poe-mcp query -t 0.7 Claude-4.5-Sonnet "Explain monads"
poe-mcp query --temperature 0.9 GPT-5.2-Pro "Write a poem"
# Attach files (local paths or URLs, auto-detected)
poe-mcp query -f photo.jpg GPT-4o "Describe this image"
poe-mcp query -f doc.pdf -f chart.png GPT-4o "Summarize these files"
poe-mcp query -f https://example.com/image.jpg GPT-4o "What's in this image?"
poe-mcp query -f local.pdf -f https://example.com/remote.pdf GPT-4o "Compare these"
Query flags:
-t,--temperature <float>— Sampling temperature (0.0-2.0, default: 0.7)-f,--file <path|url>— Attach a file: local path or URL (repeatable)
Installation
go install github.com/n0madic/poe-mcp@latest
Or build from source:
git clone https://github.com/n0madic/poe-mcp.git
cd poe-mcp
go build .
Configuration
Claude Code
Add to your Claude Code MCP settings (~/.claude/claude_desktop_config.json or project .mcp.json):
{
"mcpServers": {
"poe": {
"command": "poe-mcp",
"env": {
"POE_API_KEY": "your-poe-api-key"
}
}
}
}
Cursor / Other MCP Clients
Configure the MCP server with:
- Command:
poe-mcp - Environment:
POE_API_KEY=your-poe-api-key - Transport: stdio
Environment Variables
| Variable | Required | Description |
|---|---|---|
POE_API_KEY |
For MCP server mode and query CLI command |
Poe API key for bot queries. Not required for search CLI command. |
Getting a Poe API Key
- Go to poe.com
- Generate or copy your API key
License
MIT
README fetched from the repository 4 days ago. The original is authoritative.