Skip to content
MCP server

Photon

MCP server giving AI agents access to Photon's messaging lines across iMessage, WhatsApp

Answers · sign-in required (OAuth)

The server answered 3 hours ago with a sign-in request for OAuth (HTTP 401), so we could not list its tools.

Install
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Access
Needs sign-in (OAuth)
Version
0.1.12
Listing updated
today

Similar MCP servers

About Photon

Photon is an MCP server for communication. It can run locally on your machine or as a hosted remote server.

The Photon MCP server lets an AI client manage messaging infrastructure on a Photon account. Through it, an agent can create projects, attach phone numbers to shared iMessage lines, and query message volume or billing usage for an organization. It is offered both as a hosted remote endpoint that connects over OAuth and as a local npm package that runs over stdio with an account service key.

The README describes the local package as offering the same tools as the hosted server, minus operations for managing keys, account security, SSO or billing checkout. Its Apache 2.0 licence is listed in the repository. The docs recommend keeping client approval enabled for tools that send messages, buy numbers or lines, or change and delete resources.

The server suits developers who want an agent to handle messaging setup and reporting for Photon-hosted channels. Because message contents and webhook payloads come from third parties, the docs also warn about prompt injection when agents read incoming messages.

Install

Run in a terminal

claude mcp add --transport http mcp https://mcp.photon.codes/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.photon.codes/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.photon.codes/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.photon.codes/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.photon.codes/mcp"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://mcp.photon.codes/mcp

Enter a Name (for example "Photon"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin. When we checked, this server asked for OAuth sign-in. If its docs give you an OAuth client ID and secret, enter them in the form's OAuth Client ID and Client Secret fields.

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.photon.codes/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PHOTON_API_KEYYour Photon Account Service KeyRequired

What it does

Hosted remote endpoint
Connects to a streamable HTTP server at mcp.photon.codes with OAuth in supported clients.
Local stdio package
Runs as the @photon-ai/mcp npm package using a Photon account service key for clients that only support stdio.
Project and line management
Lets agents create projects and add phone numbers to shared iMessage lines.
Messaging usage reports
Answers questions about how many messages a project sent or received and shows billing usage.
Approval-based safety guidance
Documentation advises keeping client confirmation on for sending, purchasing and destructive actions.

Good for

  • Create a project and attach a shared iMessage line from an AI assistant
  • Check weekly message volume for a Photon project without opening the dashboard
  • Review an organization's current billing usage through a chat client
  • Let a coding agent set up Photon messaging resources during development

Photon FAQ

Do I need an API key to use the hosted server?

No. The README says the hosted server at https://mcp.photon.codes/mcp needs no key and works with clients that support remote MCP servers with OAuth.

What is the local version for?

The README says it is for clients that only run stdio servers. It requires a PHOTON_API_KEY account service key and Node.js 22 or newer.

Which messaging channels does it cover?

The registry entry describes messaging across iMessage, WhatsApp, Telegram and SMS.

Can the server manage API keys or billing checkout?

No. The README states that key management, account security, SSO and billing checkout are not available in the local server.

How do I add Photon to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.photon.codes/mcp

What are the best alternatives to Photon?

The closest alternatives to Photon are imsg-mcp, MCP Telegram Bot, ChatPush: WhatsApp, Telegram, MAX & SMS, Callsign and Selfping.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Status: checked automatically by AIPoweredBot on 19 November 2026.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers