OrcFleet MCP Server v1.0

Unified MCP server for AI agent orchestration — 45 tools, one endpoint

Quick Start

Claude Code

claude mcp add --transport sse orcfleet \
  https://mcp.orcfleet.com/mcp/sse \
  --header "Authorization: Bearer YOUR_TOKEN"

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "orcfleet": {
      "transport": "sse",
      "url": "https://mcp.orcfleet.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

OpenAI Codex CLI

# ~/.codex/config.yaml
mcp_servers:
  orcfleet:
    type: sse
    url: https://mcp.orcfleet.com/mcp/sse
    headers:
      Authorization: Bearer YOUR_TOKEN

Cursor / Windsurf / any MCP client

Transport: SSE
URL:       https://mcp.orcfleet.com/mcp/sse
Header:    Authorization: Bearer YOUR_TOKEN

Endpoints

GET https://mcp.orcfleet.com/mcp/sse

SSE stream — establishes MCP session, returns endpoint event with message URL

POST https://mcp.orcfleet.com/mcp/message?sessionId=...

JSON-RPC 2.0 messages — tool calls, responses

POST https://mcp.orcfleet.com/auth/mcp-register

Register & get token: {"email","name","password","scope"}

POST https://mcp.orcfleet.com/auth/mcp-login

Login & get token: {"email","password","scope"}

Authentication

All MCP requests require a Bearer token in the Authorization header. Get a token via /auth/mcp-register or /auth/mcp-login.

# Register
curl -X POST https://mcp.orcfleet.com/auth/mcp-register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","name":"Your Name","password":"secret123","scope":"ui_agent"}'

# Login
curl -X POST https://mcp.orcfleet.com/auth/mcp-login \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"secret123","scope":"ui_agent"}'

Token Scopes

ScopeForAccess
agentContainer agentsAgent-only tools + execution tools (row-level security)
orchestratorOrchestrator processAll tools including admin-only (assign_task, update_plan_status, write_agent_log)
ui_agentAI assistants (Claude, Cursor, etc.)All tools except admin-only

Tools (45)

Tasks

get_task all scopes
create_task all scopes
update_task all scopes
list_tasks all scopes
assign_task orchestrator
update_task_status agent
create_subtask agent

Execution

claim_next_task all scopes
heartbeat_task all scopes
complete_task all scopes
fail_task all scopes

Plans

create_plan all scopes
get_plan all scopes
update_plan_status orchestrator

Projects

create_project all scopes
get_project all scopes
list_projects all scopes

Agents

create_agent all scopes
get_agent all scopes
update_agent all scopes
delete_agent all scopes
update_agent_status all scopes

Teams

create_team all scopes
get_team all scopes
list_teams all scopes
update_team all scopes
delete_team all scopes
add_team_member all scopes
replace_team_members all scopes

Logs

write_agent_log orchestrator
get_agent_logs all scopes
list_agents all scopes

Memory (agent only)

read_memory agent
write_memory agent
update_memory_fact agent

Code Index (agent only)

parse_and_index agent
search_symbol agent
get_file_index agent
verify_hash agent
update_summary agent

Git (agent only)

write_git_log agent

Auth

get_user all scopes
update_user all scopes
issue_token all scopes
revoke_token all scopes

Health Checks

GET https://mcp.orcfleet.com/healthz   # {"status":"ok"}
GET https://mcp.orcfleet.com/readyz    # {"status":"ready"}

Protocol

MCP (Model Context Protocol) over SSE transport. JSON-RPC 2.0 messages. See modelcontextprotocol.io for the full specification.

OrcFleet — AI Agent Orchestration Platform