Model Context Protocol

MCP setup

Fuxux exposes an MCP server over Streamable HTTP. Your client sends JSON-RPC to the endpoint below with Authorization: Bearer …. Prefer a dedicated API key from API Keys (fx_live_…), or use your Supabase session.access_token if you already have it in a client.

Endpoint

https://www.fuxux.com/api/mcp/mcp

The shorter path /api/mcp works the same. For local development, swap the origin (for example http://localhost:3000/api/mcp/mcp).

Authentication

Every request to the MCP URL must include:

Authorization: Bearer <fuxux_api_key_or_supabase_jwt>

API key (recommended): create one under Settings → API keys. Keys start with fx_live_ and do not expire until you revoke them.
Supabase access token: the JWT in session.access_token after sign-in. These expire on refresh — update your client when the session rotates.

Cursor (one-click)

Set a machine environment variable to a Fuxux API key (recommended) or Supabase access token:

FUXUX_API_KEY=fx_live_your_key_here

Cursor expands ${env:NAME} in mcp.json — see Cursor MCP docs. Then click below to register the remote server (Streamable HTTP).

Add Fuxux to Cursor

Manual entry: same values in ~/.cursor/mcp.json or project .cursor/mcp.json.

{
  "mcpServers": {
    "fuxux": {
      "url": "https://www.fuxux.com/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer ${env:FUXUX_API_KEY}"
      }
    }
  }
}

Claude Code

Add to ~/.claude/settings.json (HTTP transport):

{
  "mcpServers": {
    "fuxux": {
      "type": "http",
      "url": "https://www.fuxux.com/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_FUXUX_API_KEY"
      }
    }
  }
}

Claude Desktop and stdio-only clients

Use the mcp-remote bridge so a local stdio MCP client can talk to our hosted server (same pattern as Post Bridge):

{
  "mcpServers": {
    "fuxux": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.fuxux.com/api/mcp/mcp",
        "--header",
        "Authorization: Bearer YOUR_FUXUX_API_KEY"
      ]
    }
  }
}

Tools

whoami — verify the token and load profile
list_connected_accounts — connected social accounts
get_dashboard — stats and upcoming posts
list_posts — queue / calendar (optional month, status)
create_post — create or schedule a post

REST equivalents are documented in API reference.