AkaPhoneDocs
Get started

Quickstart with Cursor and Codex

Configuration snippets for adding the AkaPhone MCP server to Cursor, OpenAI Codex and other MCP clients.

View as Markdown

The same akaphone-mcp server (version 1.0.0 or later) works in any MCP client that can launch a stdio server. It needs Node.js 20 or newer. Get a ak_live_… key from API keys in the dashboard first, and a model key for tasks (see Model keys).

Cursor#

Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json in a project:

~/.cursor/mcp.json
{
  "mcpServers": {
    "akaphone": {
      "command": "npx",
      "args": ["-y", "akaphone-mcp"],
      "env": {
        "AKAPHONE_API_KEY": "ak_live_...",
        "MODEL_API_KEY": "AIza..."
      }
    }
  }
}

Reload Cursor, then check the server is enabled in Cursor's MCP settings. Ask the agent: “Create a phone and tell me what Android version it runs.”

Codex#

Add the server to ~/.codex/config.toml:

~/.codex/config.toml
[mcp_servers.akaphone]
command = "npx"
args = ["-y", "akaphone-mcp"]

[mcp_servers.akaphone.env]
AKAPHONE_API_KEY = "ak_live_..."
MODEL_API_KEY = "AIza..."

Start a new Codex session; the AkaPhone tools are available to it.

Any other MCP client#

Run npx -y akaphone-mcp as a stdio server with these environment variables:

Variable Required Notes
AKAPHONE_API_KEY yes Your ak_live_… key.
AKAPHONE_API_URL no Defaults to https://akaphone.abhgnx-417.workers.dev.
MODEL_API_KEY for tasks Sent with each task as X-Model-Key; never stored by AkaPhone.
MODEL_PROVIDER no gemini (default), anthropic or openai. Any other value stops the server at startup with a clear error.

Next#