API reference

MCP

The Model Context Protocol server and its OAuth metadata.

POST/mcp

Send an MCP message

MCP endpoint (Streamable HTTP).

JSON-RPC 2.0. Modern (2026-07-28) requests carry _meta and the mirrored MCP-Protocol-Version, Mcp-Method and Mcp-Name headers; legacy (2025-03-26 to 2025-11-25) clients use initialize, served without sessions. A 401 names the protected resource metadata in WWW-Authenticate. Responses are JSON, or SSE with progress notifications for streaming tools.

Permission: write

Parameters

NameTypeRequiredDescription
Pluto-Workspaceheaderstring (uuid)OptionalThe workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403.

Request body

object

Response200 OK

A JSON-RPC response (or an SSE stream ending with it).

Errors

  • 400The request is malformed.
  • 401No valid credential.
  • 403The credential lacks the permission, or belongs to another workspace.
  • 429Too many requests from this credential. Wait Retry-After seconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/mcp" \
  -H "Authorization: Bearer $PLUTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
GET/.well-known/oauth-protected-resource

Get the protected resource metadata

OAuth protected resource metadata (RFC 9728).

Names the authorization server for this API and the MCP endpoint. The API host also serves it at /.well-known/oauth-protected-resource (and path-suffixed with /api/v1/mcp), outside /api/v1.

No credential

Response200 OK

authorization_serversarray of stringsRequired
Authorization servers.
bearer_methods_supportedarray of strings
Methods.
resourcestringRequired
This resource.

Errors

  • 400The request is malformed.
curl "$PLUTO_API/.well-known/oauth-protected-resource"