Mc Api Reference

Last updated: July 5, 2026

Mission Control API Reference

Mission Control dashboard (port 9999) provides 70+ REST API endpoints (growing; ~76 /api/mc* handlers in missioncontrol.go as of late 2026) for system monitoring, MrTool pipeline, AntFarm/Business Hive, observability, and admin controls.

Base URL

http://localhost:9999

๐Ÿ“ Categories

Status & Telemetry

Endpoint Method Purpose
/api/mc/status GET System status summary
/api/mc/telemetry GET Real-time telemetry pulse
/api/mc/diagnostics GET Runtime diagnostics
/api/mc/alerts GET Active system alerts
/api/mc/alerts/check POST Trigger Sovereign audit

Sessions

Endpoint Method Purpose
/api/mc/sessions GET Active chat sessions
/api/mc/session/state GET Session state by ID
/api/mc/session/control POST Pause/resume/kill session
/api/mc/planner/history GET Planner session history

Projects & Companies

Endpoint Method Purpose
/api/mc/projects GET AntFarm projects
/api/mc/companies GET Business Hive companies
/api/mc/servers GET Infrastructure servers

Scheduler

Endpoint Method Purpose
/api/mc/scheduler GET Scheduled tasks list
/api/mc/scheduler/add POST Add new scheduled task
/api/mc/scheduler/action POST Pause/resume/delete task
/api/mc/scheduler/history GET Task execution history

Analytics

Endpoint Method Purpose
/api/mc/delegation-analytics GET Planner delegation stats
/api/mc/tool-usage-by-user GET Tool usage per user
/api/mc/tool-performance GET Tool performance metrics
/api/mc/tool-usage-by-agent GET Tool usage per agent
/api/mc/tool-errors GET Tool error logs

Models

Endpoint Method Purpose
/api/mc/models GET Available models
/api/mc/free-models GET Free model rankings
/api/mc/free-models/update POST Update free model config
/api/mc/free-models/reorder POST Reorder free models

Playbooks

Endpoint Method Purpose
/api/mc/playbooks GET Active playbooks
/api/mc/playbook-analytics GET Playbook usage stats

Skills

Endpoint Method Purpose
/api/mc/skills GET Available skills catalog

MrTool (Tool Creation)

Endpoint Method Purpose
/api/mc/mrtool/pending GET Pending tools
/api/mc/mrtool/deleted GET Deleted tools
/api/mc/mrtool/approve POST Approve pending tool
/api/mc/mrtool/reject POST Reject pending tool
/api/mc/mrtool/restore POST Restore deleted tool
/api/mc/mrtool/validate/{name} POST Validate tool (.md + runtime)
/api/mc/mrtool/add POST Add tool (admin)
/api/mc/mrtool/files GET Get tool files
/api/mc/mrtool/register-pending POST Register new pending tool

Teams

Endpoint Method Purpose
/api/mc/team-agents GET Team agents status
/api/mc/team-analytics GET Team execution analytics
/api/mc/team-agent/{name} GET Individual team agent detail

Boards & Tasks

Endpoint Method Purpose
/api/mc/boards GET Task boards
/api/mc/tasks GET All tasks
/api/mc/tasks/add POST Add task
/api/mc/tasks/update POST Update task
/api/mc/tasks/delete POST Delete task
/api/mc/tasks/comment POST Add comment

Search & History

Endpoint Method Purpose
/api/mc/search GET Full-text search
/api/mc/history GET Message history
/api/mc/timeline GET Session timeline

Files

Endpoint Method Purpose
/api/mc/files/list GET List workspace files
/api/mc/files/read GET Read file content
/api/mc/files/write POST Write file
/api/mc/files/delete POST Delete file
/api/mc/logs/{sessionID} GET Session logs

Dispatch & Handoff

Endpoint Method Purpose
/api/mc/dispatch POST Dispatch agent
/api/mc/handoff POST Session handoff

Console (Live Log Stream) โ€” added ec309850

Endpoint Method Purpose
/api/mc/console/logs GET Tail /root/botlog.log. First call (no offset) returns last 500 lines + EOF byte position; subsequent calls with ?offset=N return newly written lines + new EOF position. Incomplete trailing line is held back (offset rewound to last \n); file truncation returns truncated: true so the frontend clears. See Mission Control Console.

SHIELD โ€” added 318aa581 / 29b4ebae

Endpoint Method Purpose
/api/mc/shield/decisions GET Recent SHIELD decisions (Allow / Suspicious / Critical)
/api/mc/shield/sync POST Trigger manual SyncNow() against the PromptIntel feed
/api/mc/shield/status GET Sync status (last sync time, last error, rule count)
/api/mc/shield/rules GET Current rule inventory (seeds + synced indicators)

SHIELD tabs render data/shield/SHIELD.md (generated on shield.Init() by GenerateSHIELDMD). See SHIELD System.


๐Ÿ” Authentication

Most endpoints require the AssistantMiddleware wrapper which validates:

  • API key via Authorization header
  • Session cookies for web UI access

๐Ÿ“Š Response Format

Success

{
  "success": true,
  "data": { ... }
}

Error

{
  "success": false,
  "error": "Error message"
}

๐Ÿงช Examples

Get System Status

curl http://localhost:9999/api/mc/status

Get Active Sessions

curl http://localhost:9999/api/mc/sessions

Trigger Sovereign Audit

curl -X POST http://localhost:9999/api/mc/alerts/check

Approve MrTool Tool

curl -X POST http://localhost:9999/api/mc/mrtool/approve \
  -H "Content-Type: application/json" \
  -d '{"tool_name": "my_new_tool"}'

๐Ÿ“‚ Related Documentation