Auth, runtime, and API-key reference for the first public API milestone.

This section mirrors the in-app /docs/api structure and keeps endpoint docs optimized for copy-and-run usage.

Use server-to-server API keys for control-plane routes and short-lived runtime tokens for end-user tool execution.

API surface at a glance

Identity and organization

Caller identity, organization membership, usage, and user settings.

Projects and servers

Create and manage projects, servers, API sources, and tool inventories.

Deployments and runtime

Deployment state, health checks, logs, and runtime auth exchange.

Skills and installations

Publish skills, manage versions, and handle installation lifecycle.

Method badge legend

GET Safe reads and lookups
POST Creates, actions, and token exchange
PATCH Partial updates
DELETE Revocation and removal

Quick request/response snippets

Identity check
Project create

curl "$MCPFACTORY_BASE_URL/api/v1/me" \
  -H "Authorization: Bearer $MCPFACTORY_API_KEY"

{
  "user": {
    "id": "usr_123",
    "email": "[email protected]"
  },
  "activeOrganizationId": "org_123"
}

curl -X POST "$MCPFACTORY_BASE_URL/api/v1/projects" \
  -H "Authorization: Bearer $MCPFACTORY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Support MCP" }'

{
  "project": {
    "id": "prj_987",
    "name": "Support MCP"
  }
}

API

API Reference

Auth, runtime, and API-key reference for the first public API milestone.

API surface at a glance

Identity and organization

Projects and servers

Deployments and runtime

Skills and installations

Method badge legend

Quick request/response snippets

Full reference map

​Auth, runtime, and API-key reference for the first public API milestone.

​API surface at a glance

Identity and organization

Projects and servers

Deployments and runtime

Skills and installations

​Method badge legend

​Quick request/response snippets

​Full reference map

Auth, runtime, and API-key reference for the first public API milestone.

API surface at a glance

Method badge legend

Quick request/response snippets

Full reference map