Skip to content
FollowerX
MCP

Model Context Protocol

A remote MCP server that exposes the FollowerX workspace as tools, resources and prompts. Agents use the same API keys and scopes as the HTTP API.

Connect a client

Point the client at the remote MCP URL and send the API key as Authorization: Bearer. Streamable HTTP is the default. Clients that only speak stdio can bridge with npx mcp-remote.

https://mcp.followerx.ae/mcp
https://mcp.followerx.ae/sse

Cursor

{
  "mcpServers": {
    "followerx": {
      "url": "https://mcp.followerx.ae/mcp",
      "headers": {
        "Authorization": "Bearer fx_live_your_key"
      }
    }
  }
}

Claude / Claude Desktop (HTTP)

{
  "mcpServers": {
    "followerx": {
      "type": "http",
      "url": "https://mcp.followerx.ae/mcp",
      "headers": {
        "Authorization": "Bearer fx_live_your_key"
      }
    }
  }
}

stdio bridge

{
  "mcpServers": {
    "followerx": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.followerx.ae/mcp"],
      "env": {
        "AUTH_HEADER": "Bearer fx_live_your_key"
      }
    }
  }
}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "followerx_jobs_create",
    "arguments": {
      "sku": "short_form_edit",
      "title": "Reel cut from the Berlin shoot",
      "platform": "tiktok",
      "brief": "30 seconds, captions on, first hook in 1.5s."
    }
  }
}

Tools

Each tool maps to one HTTP endpoint and requires the same scope. Arguments use snake_case. The server never asks for social-network passwords.

followerx_account_get
Get account

Read workspace profile and locale.

GET /v1/account · account:read
followerx_account_update
Update account

Patch company name, locale or notification email.

PATCH /v1/account · account:write
followerx_balance_get
Get balance

Read available and reserved tokens.

GET /v1/balance · account:read
followerx_ledger_list
List ledger

Page token movements.

GET /v1/ledger · account:read
followerx_catalog_list
List catalogue

List published SKUs and token prices.

GET /v1/catalog · catalog:read
followerx_catalog_get
Get SKU

Read one catalogue item by sku.

GET /v1/catalog/{sku} · catalog:read
followerx_platforms_list
List platforms

Networks the studio works on.

GET /v1/platforms · catalog:read
followerx_profiles_list
List profiles

Connected social profiles.

GET /v1/profiles · profiles:read
followerx_profiles_create
Add profile

Register a handle. Never send passwords.

POST /v1/profiles · profiles:write
followerx_jobs_list
List jobs

Filter work requests by status or SKU.

GET /v1/jobs · jobs:read
followerx_jobs_get
Get job

Read one job, quote and deliverables.

GET /v1/jobs/{id} · jobs:read
followerx_jobs_create
Create job

Open a catalogue work request.

POST /v1/jobs · jobs:write
followerx_jobs_accept_quote
Accept quote

Reserve tokens and start work.

POST /v1/jobs/{id}/quote/accept · jobs:write
followerx_jobs_decline_quote
Decline quote

Cancel a quoted job without a charge.

POST /v1/jobs/{id}/quote/decline · jobs:write
followerx_jobs_request_revision
Request revision

Ask for an included or quoted revision.

POST /v1/jobs/{id}/revisions · jobs:write
followerx_jobs_approve
Approve job

Accept the deliverable and capture tokens.

POST /v1/jobs/{id}/approve · jobs:write
followerx_jobs_cancel
Cancel job

Cancel and release unused reserved tokens.

POST /v1/jobs/{id}/cancel · jobs:write
followerx_deliverables_list
List deliverables

List finished files and reports.

GET /v1/deliverables · deliverables:read
followerx_deliverables_get
Get deliverable

Read metadata and signed file URLs.

GET /v1/deliverables/{id} · deliverables:read
followerx_invoices_list
List invoices

List tax invoices for token purchases.

GET /v1/invoices · invoices:read
followerx_invoices_get
Get invoice

Read one invoice including VAT breakdown.

GET /v1/invoices/{id} · invoices:read
followerx_webhooks_list
List webhooks

List registered webhook endpoints.

GET /v1/webhooks · webhooks:read
followerx_webhooks_create
Create webhook

Subscribe an HTTPS URL to job and balance events.

POST /v1/webhooks · webhooks:write

Resources

followerx://account  application/json
followerx://balance  application/json
followerx://catalog  application/json
followerx://jobs  application/json
followerx://platforms  application/json

Prompts

brief_content_job
Brief a content job

Collect platform, SKU, hook and references, then call followerx_jobs_create.

weekly_status
Weekly status

Summarise open jobs, reserved tokens and deliverables waiting for approval.

spend_review
Spend review

Read the ledger and catalogue and explain where the balance went.

Safety

The server will not create jobs for followers, likes, views or any other purchased metric. Those requests return 422 with code validation_error. Community tools only accept manual engagement briefs.

The API and MCP do not sell or report purchased followers, likes or views. Analytics endpoints return only work you requested against the published catalogue.

Questions about the API or MCP: trepteventures@proton.me