MCP

MCP JSON-RPC endpoint

post

Handle MCP protocol requests. This endpoint implements the Model Context Protocol and can be connected to by any MCP client (Claude Desktop, etc.).

Required scope: mcp

Authentication: Requires a valid BlueNexus access token in the Authorization header.

Supported methods:

• initialize: Initialize MCP session

• tools/list: List available tools (returns use-agent and list-connections)

• tools/call: Execute a tool (use-agent to run an AI agent with a prompt, list-connections to list active MCP connections)

Authorizations

access-tokenbearer

AuthorizationstringRequired

Enter JWT access token

Header parameters

AuthorizationstringOptional

Required. Pass the user's access token as a bearer token

AcceptstringRequired

Must include both application/json and text/event-stream. The server may respond with either format.

Default: application/json, text/event-stream

Body

application/json

A JSON-RPC request object for the Universal MCP endpoint

jsonrpcstring · enumRequired

JSON-RPC protocol version

Example: 2.0Possible values:

methodstringRequired

The name of the method to be invoked

Example: tools/call

paramsone ofOptional

Parameters for the method call, can be an object or array

Example: {"name":"use-agent","arguments":{"prompt":"What's on my Google Calendar today?"}}

or

object[]Optional

idone ofRequired

Unique identifier for the request, can be string, number, or null (discouraged)

Example: req-123

stringOptional

or

numberOptional

or

nullOptional

Responses

200

JSON-RPC response

application/json, text/event-stream

401

Unauthorized. Missing or invalid account access token.

application/json

406

Client must accept both application/json and text/event-stream

429

Insufficient credits to process request

500

Internal server error

application/json

post

/mcp

HTTPcURLJavaScriptPython

POST /mcp HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json, text/event-stream
Content-Type: application/json
Content-Length: 177

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "use-agent",
    "arguments": {
      "prompt": "What's on my Google Calendar today?",
      "connection": "google-workspace"
    }
  },
  "id": "req-123"
}

Call the use-agent toolCall the list-connections tool