Repository avatar
AI Tools
v0.1.12
active

mcp

io.github.photon-hq/mcp

Messaging infrastructure for AI agents across iMessage, WhatsApp, Telegram and SMS.

Documentation

Photon MCP Server

Use Photon from any MCP client.

If your client supports remote MCP servers with OAuth (Claude, ChatGPT, Cursor), connect to the hosted server instead: https://mcp.photon.codes/mcp. No key is needed. Use this local server when your client only runs stdio servers.

Setup

  1. Create an Account Service Key (pho_ask_...) in the Photon dashboard.
  2. Add the server to your client. Node.js 22 or newer is required.

Claude Code:

claude mcp add photon --env PHOTON_API_KEY=pho_ask_... -- npx -y @photon-ai/mcp

Cursor, Claude Desktop and other JSON-configured clients:

{
  "mcpServers": {
    "photon": {
      "command": "npx",
      "args": ["-y", "@photon-ai/mcp"],
      "env": { "PHOTON_API_KEY": "pho_ask_..." }
    }
  }
}

Configuration

VariableDefaultDescription
PHOTON_API_KEYrequiredYour Account Service Key
PHOTON_API_URLhttps://api.photon.codesAPI origin. Only photon.codes and loopback hosts are accepted

The server offers the same tools as the hosted server. Operations that manage keys, account security, SSO or billing checkout are not available. Your client decides when to ask before running a tool, so set it to confirm writes.

License

Apache 2.0

NPM
@photon-ai/mcp
Install Command
npm install @photon-ai/mcp

Remote