Codex

Codex can use Synapse Remote MCP through Streamable HTTP.

BYOK Agent Key

Add the hosted MCP endpoint:

codex mcp add synapse-remote-mcp \
  --url https://mcp.synapse-network.ai/mcp \
  --bearer-token-env-var SYNAPSE_AGENT_KEY

Set your Agent Key:

export SYNAPSE_AGENT_KEY=agt_xxx

Check the configuration:

codex mcp get synapse-remote-mcp

Add the OAuth version:

codex mcp add synapse-remote-mcp-oauth \
  --url https://mcp.synapse-network.ai/mcp \
  --oauth-client-id codex \
  --oauth-resource https://mcp.synapse-network.ai/mcp

codex mcp login synapse-remote-mcp-oauth \
  --scopes synapse.discovery.read,synapse.receipts.read,offline_access

The browser authorization flow redirects to Synapse. If the page reports that wallet connection is unavailable, install or enable MetaMask or Rabby and retry.

Verify

codex mcp list

Expected result:

synapse-remote-mcp is enabled with bearer-token auth, or
synapse-remote-mcp-oauth is enabled and logged in.

First prompt

Use the Synapse MCP server to discover services for weather data. Do not call invoke_and_pay.

BYOK Agent Key

OAuth login

Verify

First prompt

On this page