MCP

Send an MCP JSON-RPC message

Sends MCP initialize, tools/list, tools/call, resources/list, resources/read, or notification messages. Read-only tools require deploy:read; deployment and app mutation tools require deploy:write; delete_app requires deploy:delete.

post/mcp

Request

  • Base URL: https://api-v2.appdeploy.ai
  • URL: https://api-v2.appdeploy.ai/mcp
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://api-v2.appdeploy.ai/mcp/authorize, token URL https://api-v2.appdeploy.ai/mcp/token)
    • HTTP bearer

Headers

Mcp-Session-Idstring

Session identifier returned by a prior initialize response.

Request body

jsonrpc'2.0' required
methodstring required
paramsobject

Example request

{
  "method": "initialize"
}

Response

MCP JSON-RPC response or event stream. A tools/call made with insufficient scope returns a successful JSON-RPC envelope whose tool result has isError: true and identifies the required scope.

jsonrpc'2.0' required
resultunknown

Changes

No recorded changes to this operation across all 1 revision of this API.