MCP Server & API-Referenz

Schnellstart

Verbinde deinen Agent in unter 5 Minuten.

1. Personal Access Token holen

Melde dich bei ExecuFunction an, gehe zu Einstellungen → API Tokens und erstelle ein neues Token. Tokens sind beschraenkt — du waehlst, auf welche Domains das Token zugreifen kann.

2. MCP-Client konfigurieren

Fuege ExecuFunction zur MCP-Konfiguration deines Agents hinzu. Funktioniert mit Claude Code, Cursor, Windsurf und jedem MCP-kompatiblen Client.

{
  "mcpServers": {
    "execufunction": {
      "url": "https://mcp.execufunction.com/sse",
      "headers": {
        "Authorization": "Bearer exf_pat_your_token_here"
      }
    }
  }
}

3. Verbindung ueberpruefen

Bitte deinen Agent, deine Projekte oder Aufgaben aufzulisten. Wenn Daten zurueckkommen, bist du verbunden.

# Agent calls:
project_list()
task_list(status: "in_progress")
calendar_list_events(startDate: "2026-02-17", endDate: "2026-02-23")

# Agent now has your full operational context.

CLI Installation

The ExecuFunction CLI gives you the same 60+ tools from your terminal. Same API, same data, same permissions — just a different interface.

1. Install

npm install -g @execufunction/cli

2. Authenticate

The CLI uses device flow authentication — it opens your browser, you approve, and a token is stored locally.

$ exf auth login

  Your verification code: ZFMV-SBGJ

  Opening browser...
  If the browser didn't open, visit: https://execufunction.com/app/device?code=ZFMV-SBGJ

  Waiting for authorization...
  Logged in successfully!

3. Run your first command

$ exf projects list

 NAME                STATUS    TASKS
 ExecuFunction       active    12
 Marketing Site      active    4
 Mobile App          planning  0

$ exf projects context <id>

# Full project context: tasks, signals, notes, members.

Authentifizierung

ExecuFunction supports two authentication methods. Use device flow for interactive CLI sessions, or Personal Access Tokens for MCP clients and CI/CD.

Device Flow (CLI)

Run exf auth login. The CLI opens your browser, you sign in with Google and approve the device code. A PAT is generated and stored in ~/.config/exf/ automatically. No token to copy-paste.

Personal Access Token (MCP & API)

For MCP clients and programmatic access, create a token in Settings → API Tokens. Pass it in the Authorization header:

Authorization: Bearer exf_pat_your_token_here

Tokens are scoped to specific domains (tasks-only, calendar-only, full access, etc.). For CI pipelines, set EXF_PAT as an environment variable.

$ exf auth login
$ exf auth status
$ exf auth logout

MCP-Verbindung

ExecuFunction nutzt den Server-Sent Events (SSE)-Transport fuer MCP. Der Endpunkt ist:

https://mcp.execufunction.com/sse

Kompatibel mit jedem MCP-Client, der SSE-Transport unterstuetzt: Claude Code, Claude Desktop, Cursor, Windsurf, Continue und eigene Implementierungen mit dem MCP SDK.

Aufgaben

$ exf tasks list --status in_progress

 TITLE                     STATUS        PRIORITY   DUE
 Ship CLI docs             in_progress   do_now     2026-02-27
 Fix device flow auth      in_progress   do_now     -

$ exf tasks create --title "Review PR #312" --priority do_now --json
{"id":"abc-123","title":"Review PR #312","status":"inbox","priority":"do_now"}

Kalender

$ exf calendar list --start 2026-02-24 --end 2026-02-28

 TITLE                  START              END                LOCATION
 Team standup           Feb 25 09:00       Feb 25 09:30       Zoom
 Product review         Feb 26 14:00       Feb 26 15:00       Conf Room B

$ exf calendar create --title "Ship CLI v0.3" \
    --start-time 2026-02-27T10:00:00Z --end-time 2026-02-27T10:30:00Z

Projekte

Wissen

Datasets

Structured datasets support grounded summaries, grouped analysis, ranking, bucketing, time-series work, import/export, schema changes, and record mutations from the same CLI and MCP-backed platform.

$ exf datasets list
$ exf datasets summarize <dataset-id>
$ exf datasets analyze <dataset-id> --focus-fields BMI,Outcome
$ exf datasets aggregate <dataset-id> --group-by Outcome \
    --metrics '[{"operation":"count","as":"rows"},{"operation":"avg","field":"BMI","as":"avg_bmi"}]'
$ exf datasets compare <dataset-id> --segment-field Outcome \
    --metrics '[{"operation":"avg","field":"Glucose","as":"avg_glucose"}]'
$ exf datasets rank <dataset-id> --sorts '[{"field":"BMI","direction":"desc"}]' --limit 10
$ exf datasets bucket <dataset-id> --field Age --bucket-count 5 \
    --metrics '[{"operation":"count","as":"rows"}]'

Kontakte

Codebase

Indexiere deine Repositories fuer semantische Codesuche. ExecuFunction parst deinen Code in Symbole und Embeddings fuer schnellen Abruf.

$ exf code history <repo-id> --path src/auth/service.ts
$ exf code blame src/auth/service.ts --root .
$ exf code expertise <repo-id>
$ exf code who-knows <repo-id> src/auth
$ exf code link <task-id> --repo <repo-id> --file src/auth/service.ts

Code-Gedaechtnis

Speichere und rufe Fakten ueber deine Codebase ab. Architektur-Entscheidungen, Konventionen, Fallstricke, Zustaendigkeiten — persistentes Wissen, das Sessions ueberdauert.

Dokumente

Vault

Encrypted secret storage. Store API keys, credentials, OAuth tokens, SSH keys, and sensitive notes. Values are encrypted at rest and audit-logged on read.

$ exf vault create --name "Stripe API Key" --json
# Interactive prompt for sensitive payload values

$ exf vault list

 NAME                TYPE         CATEGORY     CREATED
 Stripe API Key      env_var      payments     2026-02-25
 GitHub PAT          credential   devtools     2026-02-20

$ exf vault read --entry-id <id>
# Decrypts and displays. Audit-logged.

Workflows

Cross-domain recipes that combine multiple tools. These patterns work identically via MCP or CLI.

Link Code to Tasks

Connect implementation work to the task that motivated it. Agents and teammates can trace why code changed.

task_create(title: "Implement device flow auth", priority: "do_now")
# ... implement the feature ...
task_link_code(taskId: "abc-123", repositoryId: "repo-456",
  commitSha: "5cf5f22", filePath: "src/services/deviceAuthService.ts",
  notes: "Fixed verification_uri to use /app/device")
task_complete(taskId: "abc-123")

$ exf tasks create --title "Implement device flow auth" --priority do_now
$ exf code link abc-123 --repo repo-456 \
    --commit 5cf5f22 --file src/services/deviceAuthService.ts
$ exf tasks complete abc-123

Project Onboarding

New to a project? Pull the full context in three commands.

# 1. Get the big picture
$ exf projects context <id>

# 2. See what's in flight
$ exf tasks list --project <id> --status in_progress

# 3. Check code conventions
$ exf code memory search "architecture and conventions"

End-of-Day Review

Summarize what happened today. Works great as an agent prompt or a manual check.

# Agent calls:
calendar_list_events(startDate: "2026-02-26", endDate: "2026-02-26")
task_list(status: "completed", limit: 20)
task_list(status: "in_progress")

# Agent now has: today's meetings, completed tasks, and remaining work.
# It can draft a standup summary, update project status, or flag blockers.

$ exf calendar list --start 2026-02-26 --end 2026-02-26
$ exf tasks list --status completed --limit 20 --json | jq '.[] | .title'
$ exf tasks list --status in_progress

Store a Debug Discovery

Found a gotcha? Store it so your future self (or your agent) doesn't rediscover it the hard way.

$ exf code memory store \
    --fact "Device flow verification_uri must use /app/device (SPA path), not /device (marketing homepage)" \
    --category gotcha \
    --file src/services/deviceAuthService.ts

Credits & Abrechnung

Jeder Workspace nutzt eine Credit-basierte Abrechnung für Chat, Analysen und toolgestützte Aktionen. Leseoperationen sind in der Regel günstiger als aufwendigere Schlussfolgerungen oder mehrstufige Analysen.

Jeder neue Nutzer erhält bei der Anmeldung 200 Credits, und diese 200 Credits werden jeden Monat erneuert. Die kostenlose Version umfasst Fast-Tier-Modelle und das Kernsystem der Kontextmanagement-Tools.

Siehe execuTerm Preise für die Credit-Kosten pro Modell und Plandetails.

Idempotenz

Schreib-Operationen (task_create, note_create, calendar_create_event etc.) akzeptieren einen optionalen idempotencyKey-Parameter. Wenn du eine Anfrage mit demselben Key wiederholst, gibt ExecuFunction das urspruengliche Ergebnis zurueck, statt ein Duplikat zu erstellen.

task_create(
  title: "Review PR #247",
  priority: "do_now",
  idempotencyKey: "agent-run-42-task-pr247"
)

# Safe to retry. Same key = same result.

Berechtigungen

Tokens sind pro Domain beschraenkt. Ein Kalender-only-Token kann keine Aufgaben oder Kontakte lesen. Beschraenke deine Tokens auf den minimalen Zugriff, den dein Agent braucht.

Verfuegbare Scopes:

• tasks — Task CRUD and completion
• calendar — Event listing and creation
• projects — Project management and context
• knowledge — Notes, search, document upload
• people — Contact search
• code — Codebase indexing, search, memory, blame
• * — Full access (all domains)

Verfügbare Schreiboperationen hängen von Ihrem Token-Scope und dem aktuellen Workspace-Tarif ab. Überprüfen Sie das von Ihnen ausgestellte Token und die aktuelle Preisseite, bevor Sie sich in der Produktion auf Schreibvorgänge verlassen.