Admin · OpenAPI

Integration API Specification

AiM Continuity is exposed through both a standard REST API and a remote MCP server. Both share one intelligence layer. External AI may read records and submit recommendations — never delete, approve, or reconfigure.

Machine-readable spec

GET /api/openapi.json

REST Endpoints

Method	Path	Description
GET	/api/health	Service health check (public).
GET	/api/openapi.json	This OpenAPI 3.1 specification (machine-readable).
POST	/api/continuity/intake	Primary universal intake.
POST	/api/recommendations	Submit a full continuity recommendation (REST MCP equivalent).
GET	/api/recommendations/pending	List pending recommendations.
GET	/api/projects	List projects.
GET	/api/projects/:id	Get a project.
GET	/api/conversations	List conversations.
GET	/api/tasks	List tasks.
POST	/api/tasks/recommend	Submit a task recommendation.
GET	/api/decisions	List decisions.
POST	/api/decisions/recommend	Submit a decision recommendation.
POST	/api/ideas/recommend	Submit an idea recommendation.
GET	/api/workstreams	List workstreams.
GET	/api/search?q=	Search across all records.

Remote MCP Server

Streamable HTTP transport at /mcp. JSON-RPC 2.0. Controlled tools only.

Tool	Category	Description
search_continuity	READ	Search projects, conversations, decisions, tasks, ideas, assets.
get_projects	READ	List all projects.
get_project	READ	Get a single project.
get_workstreams	READ	List workstreams.
get_conversation	READ	List / fetch conversations.
get_tasks	READ	List tasks.
get_decisions	READ	List decisions (incl. superseded).
get_pending_recommendations	READ	List pending recommendations (read-only).
submit_continuity_recommendation	RECOMMEND	Submit a full recommendation (pending).
submit_task_recommendation	RECOMMEND	Submit a single task (pending).
submit_decision_recommendation	RECOMMEND	Submit a single decision (pending).
submit_idea_recommendation	RECOMMEND	Submit a single idea (pending).
link_related_record	RECOMMEND	Suggest a relationship between records (pending).

json-rpc

POST /mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize"
}

→ { "jsonrpc": "2.0", "id": 1, "result": {
  "protocolVersion": "2025-06-18",
  "capabilities": { "tools": { "listChanged": false } },
  "serverInfo": { "name": "aim-continuity-mcp", "version": "1.0.0" }
} }

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "search_continuity",
    "arguments": { "query": "pricing" }
  }
}

Tool Permissions

Allowed

· Read: search, get, list
· Recommend: submit, suggest update, suggest link
· Create pending records

Never exposed

· Delete project / conversation / task / asset
· Approve recommendation
· Change permissions or authentication
· Manage system configuration

Principle

AI Recommends. Humans Decide. Every write — REST or MCP — creates a PENDING_REVIEW AiM Recommendation. Permanent organizational changes require human approval.