Skip to main content
POST
/
mcp
curl --request POST \
  --url https://api.stackone.com/mcp \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "method": "initialize",
  "params": {
    "clientInfo": {
      "name": "my-client",
      "version": "1.0.0"
    },
    "protocolVersion": "2025-03-26",
    "capabilities": {}
  },
  "id": "init-1"
}
'
{
  "statusCode": 400,
  "message": "Bad Request",
  "timestamp": "2023-05-30T00:00:00.000Z",
  "data": {
    "statusCode": 400,
    "message": "Bad Request",
    "headers": {
      "content-type": "application/json",
      "x-request-id": "5678c28b211dace4e0a0f9171e6b88c5"
    }
  },
  "provider_errors": [
    {
      "status": 400,
      "url": "https://api.provider.com/v1/resource",
      "raw": {
        "message": "Invalid input parameters"
      },
      "headers": {
        "content-type": "application/json",
        "x-request-id": "5678c28b211dace4e0a0f9171e6b88c5"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

​
x-account-id
string

Account secure id for the target provider account (optional if x-account-id query parameter is provided)

​
mcp-session-id
string

Session id; omit for initialize, include for subsequent calls

Query Parameters

​
tool-mode
enum<string>

Tool registration mode: "individual" (default) registers each action as a separate tool; "search_execute" registers two tools for search-and-execute flow

Available options:
individual,
search_execute

Body

application/json

JSON-RPC 2.0 message

​
jsonrpc
string
required

JSON-RPC protocol version

Example:

"2.0"

​
method
string
required

JSON-RPC method name

Example:

"initialize"

​
params
object

Method parameters (arbitrary JSON)

​
id
object

Request id (arbitrary JSON scalar)

Response

Processed successfully