Frequently Asked Questions (FAQ)

What is a Poe Proxy MCP Server?

The Poe Proxy MCP Server is a FastMCP server that acts as a proxy for the Poe.com API. It allows you to query Poe models like Claude 3 Opus and GPT-4o from your applications, supporting both STDIO and SSE transports.

What is MCP?

MCP stands for Model Context Protocol. It’s an open protocol that standardizes how applications provide context to Large Language Models (LLMs), enabling better interaction and more relevant responses.

What models are supported by this server?

The server supports various models available on Poe, including GPT-4o, Claude 3 Opus, Claude 3 Sonnet, and Gemini Pro.

How do I install the Poe Proxy MCP Server?

You can install it using the provided install.sh script or manually by cloning the repository, creating a virtual environment, and installing the dependencies.

What is a Poe API key and where do I get it?

A Poe API key is required to authenticate with the Poe.com API. You can obtain one from Poe.com.

How do I configure the server?

The server can be configured using environment variables such as POE_API_KEY, DEBUG_MODE, and SESSION_EXPIRY_MINUTES.

What are STDIO and SSE transports?

STDIO (Standard Input/Output) is suitable for command-line usage. SSE (Server-Sent Events) enables the server to be used with web clients for real-time communication.

How do I run the server in STDIO mode?

Run the server using the command poe-mcp or python poe_server.py.

How do I run the server in SSE mode?

Run the server using the command poe-mcp-sse [port] or python run_sse_server.py [port], specifying the port if desired.

What is the ask_poe tool?

The ask_poe tool allows you to ask a question to a Poe bot, specifying the bot, prompt, and session ID.

What is the ask_with_attachment tool?

The ask_with_attachment tool allows you to ask a question to a Poe bot with a file attachment.

How do I clear a session’s conversation history?

Use the clear_session tool, providing the session ID to clear.

How do I list available Poe models?

Use the list_available_models tool.

How do I get information about the server configuration?

Use the get_server_info tool.

How do I use the web client?

Start the server in SSE mode, open examples/web_client.html in your browser, and enter the server URL.

How do I run the test suite?

Run the test suite using the command python run_tests.py.

What do I do if I encounter an authentication error?

Make sure your Poe API key is correct in the .env file.

What do I do if I encounter a connection error?

Check that you can access Poe.com from your network.

What do I do if I encounter a file upload error?

Ensure the file exists and is within the size limit.

What do I do if I encounter issues with Claude’s thinking protocol?

Try disabling it by setting CLAUDE_COMPATIBLE=false in your .env file.