Execute MCP protocol requests

Routes MCP protocol requests (JSON-RPC 2.0) to the specified MCP Server asset.

Supported methods:

  • tools/list: Retrieve available tools for the asset
  • tools/call: Execute a specific tool with arguments

Rate Limiting: 500 calls per minute per asset. When exceeded, the response will contain an error with isError=true and retry guidance.

SecurityBearerAuth
Request
path Parameters
asset_id
required
string <uuid>

The unique identifier (UUID) of the MCP Server asset

Example: 56b10c32-97c5-4060-8e3d-12e040f889f2
query Parameters
draft
boolean
Default: false

Optional flag to indicate draft mode access

Request Body schema: application/json

JSON-RPC 2.0 formatted MCP request

jsonrpc
required
string

JSON-RPC protocol version

Value: "2.0"
required
string or integer

Unique identifier for the request (will be echoed in response)

method
required
string

MCP method name

Enum: "tools/list" "tools/call"
object

Method-specific parameters

Responses
200

Successful MCP response

404

Not Found - The specified resource was not found. This may occur when:

  • The asset_id doesn't exist
  • The asset is not accessible to the authenticated user
  • The MCP Server feature is not active for this team
500

Internal Server Error - An unexpected error occurred on the server.

post/studio-copilot/api/v1/mcp-servers/mcp/{asset_id}
Request samples
application/json
{
  • "jsonrpc": "2.0",
  • "id": 1,
  • "method": "tools/list",
  • "params": { }
}
Response samples
application/json
{
  • "jsonrpc": "2.0",
  • "id": "string",
  • "result": {
    }
}