MCP

Model Context Protocol

Ein entfernter MCP-Server, der den FollowerX-Arbeitsbereich als Tools, Ressourcen und Prompts bereitstellt. Agenten nutzen dieselben API-Schlüssel und Scopes wie die HTTP-API.

Client verbinden

Richten Sie den Client auf die Remote-MCP-URL und senden Sie den API-Schlüssel als Authorization: Bearer. Streamable HTTP ist der Standard. Clients, die nur stdio sprechen, können mit npx mcp-remote brücken.

https://mcp.followerx.de/mcp
https://mcp.followerx.de/sse

Cursor

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

Claude / Claude Desktop (HTTP)

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

stdio bridge

{
  "mcpServers": {
    "followerx": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.followerx.de/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

Jedes Tool entspricht einem HTTP-Endpunkt und braucht denselben Scope. Argumente in snake_case. Der Server fragt niemals Social-Network-Passwörter ab.

followerx_account_get

Konto abrufen

Liest Arbeitsbereich und Sprache.

GET /v1/account · account:read

followerx_account_update

Konto aktualisieren

Ändert Firmenname, Sprache oder Benachrichtigungs-E-Mail.

PATCH /v1/account · account:write

followerx_balance_get

Guthaben abrufen

Liest verfügbare und reservierte Tokens.

GET /v1/balance · account:read

followerx_ledger_list

Kontobuch listen

Blättert Token-Bewegungen.

GET /v1/ledger · account:read

followerx_catalog_list

Katalog listen

Listet veröffentlichte SKUs und Token-Preise.

GET /v1/catalog · catalog:read

followerx_catalog_get

SKU abrufen

Liest einen Katalogeintrag per sku.

GET /v1/catalog/{sku} · catalog:read

followerx_platforms_list

Plattformen listen

Netzwerke, auf denen das Studio arbeitet.

GET /v1/platforms · catalog:read

followerx_profiles_list

Profile listen

Verbundene Social-Profile.

GET /v1/profiles · profiles:read

followerx_profiles_create

Profil anlegen

Registriert ein Handle. Niemals Passwörter senden.

POST /v1/profiles · profiles:write

followerx_jobs_list

Jobs listen

Filtert Arbeitsanfragen nach Status oder SKU.

GET /v1/jobs · jobs:read

followerx_jobs_get

Job abrufen

Liest einen Job, das Angebot und Lieferungen.

GET /v1/jobs/{id} · jobs:read

followerx_jobs_create

Job anlegen

Öffnet eine Katalog-Arbeitsanfrage.

POST /v1/jobs · jobs:write

followerx_jobs_accept_quote

Angebot annehmen

Reserviert Tokens und startet die Arbeit.

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

followerx_jobs_decline_quote

Angebot ablehnen

Storniert einen angebotenen Job ohne Belastung.

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

followerx_jobs_request_revision

Korrektur anfordern

Fordert eine enthaltene oder angebotene Korrektur an.

POST /v1/jobs/{id}/revisions · jobs:write

followerx_jobs_approve

Job abnehmen

Nimmt die Lieferung ab und zieht Tokens ein.

POST /v1/jobs/{id}/approve · jobs:write

followerx_jobs_cancel

Job stornieren

Storniert und gibt ungenutzte reservierte Tokens frei.

POST /v1/jobs/{id}/cancel · jobs:write

followerx_deliverables_list

Lieferungen listen

Listet fertige Dateien und Reports.

GET /v1/deliverables · deliverables:read

followerx_deliverables_get

Lieferung abrufen

Liest Metadaten und signierte Datei-URLs.

GET /v1/deliverables/{id} · deliverables:read

followerx_invoices_list

Rechnungen listen

Listet Rechnungen für Token-Käufe.

GET /v1/invoices · invoices:read

followerx_invoices_get

Rechnung abrufen

Liest eine Rechnung inkl. MwSt.-Aufschlüsselung.

GET /v1/invoices/{id} · invoices:read

followerx_webhooks_list

Webhooks listen

Listet registrierte Webhook-Endpunkte.

GET /v1/webhooks · webhooks:read

followerx_webhooks_create

Webhook anlegen

Abonniert eine HTTPS-URL für Job- und Guthaben-Events.

POST /v1/webhooks · webhooks:write

Ressourcen

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

Prompts

brief_content_job

Content-Job briefen

Sammelt Plattform, SKU, Hook und Referenzen und ruft dann followerx_jobs_create auf.

weekly_status

Wochenstatus

Fasst offene Jobs, reservierte Tokens und Lieferungen zur Freigabe zusammen.

spend_review

Ausgabenüberblick

Liest Kontobuch und Katalog und erklärt, wohin das Guthaben ging.

Sicherheit

Der Server legt keine Jobs für Follower, Likes, Views oder andere gekaufte Kennzahlen an. Solche Anfragen liefern 422 mit code validation_error. Community-Tools akzeptieren nur Briefings für manuelle Betreuung.

API und MCP verkaufen und melden keine gekauften Follower, Likes oder Views. Analytics-Endpunkte liefern nur Arbeit, die Sie gegen den veröffentlichten Katalog angefragt haben.

Fragen zur API oder zum MCP: trepteventures@proton.me