
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
- Create an Account Service Key (
pho_ask_...) in the Photon dashboard. - 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
| Variable | Default | Description |
|---|---|---|
PHOTON_API_KEY | required | Your Account Service Key |
PHOTON_API_URL | https://api.photon.codes | API 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
NPM
@photon-ai/mcpInstall Command
npm install @photon-ai/mcpRemote
streamable-http
https://mcp.photon.codes/mcp