# Forkit

> The Reasoning Layer for Agent Swarms.

Forkit is a hosted MCP server that gives AI agents persistent, multi-tenant task
coordination with V8 sandboxed code execution — over a single endpoint with no
infrastructure to run. Connect with a guest token in one line, no sign-up required.

MCP endpoint: https://forkit-mcp.com/mcp

## Authentication

Bearer token (after GitHub OAuth):
  Authorization: Bearer <api-key>

Guest mode (zero sign-up, auto-provisioned workspace):
  Authorization: Guest <any-stable-identifier>

## 7 MCP Tools

- execute_code     Run async JavaScript in a real V8 isolate. All DB operations are
                   available as `await codemode.*` calls. Fixed ~1k token cost
                   regardless of how many operations the agent performs.
- search_api       Returns the full TypeScript type definitions for the codemode SDK.
                   Call once at session start to get the full API surface.
- ready_tasks      Topological zero-blocker task queue. Returns only tasks whose
                   blockers are all resolved — the agent's starting point each session.
- claim_task       Atomic, race-condition-safe task assignment. CAS semantics prevent
                   two agents claiming the same task simultaneously.
- wait_for_task    Long-poll until a task is assigned to this agent (up to 120 s,
                   ~250 ms KV-signaled wakeup). Returns immediately if one is ready.
- summarize_session  AI digest of session work → written to R2 memory as Markdown.
                   Cost: $0.05 USDC (x402).
- list_executions  Execution audit log — status, duration, errors for recent
                   execute_code calls in this workspace.

## codemode SDK (inside execute_code)

Tasks:    list_tasks, get_task, ready_tasks, create_task, claim_task,
          update_task, add_dependency, delete_task
Projects: create_project, list_projects, get_project, update_project
Sprints:  create_sprint, list_sprints, get_active_sprint, update_sprint
Comments: add_comment, list_comments
Labels:   create_label, list_labels, add_label_to_task, remove_label_from_task
Sessions: start_session, log_activity, complete_session, list_sessions
Webhooks: register_webhook, list_webhooks, delete_webhook
Payments: list_payments

Task statuses: pending → in_progress → done | cancelled
Task ID format: tk-a1b2c3

## Pricing (x402 — USDC on Base L2)

create_task:       Free for first 50 tasks per workspace, then $0.01 USDC
summarize_session: $0.05 USDC
All other tools:   Free

Agents pay per outcome from their own crypto wallet. No credit card, no accounts.

## Quick start (Claude Code)

Add to claude_desktop_config.json or .claude/settings.json:
{
  "mcpServers": {
    "forkit": {
      "url": "https://forkit-mcp.com/mcp",
      "headers": { "Authorization": "Guest my-project-name" }
    }
  }
}

## Links

Docs:    https://forkit-mcp.com/docs
GitHub:  https://github.com/forkit-mcp/forkit
Health:  https://forkit-mcp.com/health