MCP Transport
The single transport endpoint for all MCP communication. All tool calls, resource reads, and protocol messages are sent here as JSON-RPC 2.0 requests.
This is a stateless endpoint — each request creates a fresh server instance scoped to the authenticated user.
Every request must send Content-Type: application/json and an Accept header listing both application/json and text/event-stream; responses are always JSON. The body is a single JSON-RPC message or an array of them. Notifications (such as notifications/initialized) carry no id and receive an empty 202 response.
curl --request POST \
--url https://mcp.seamless.ai/mcp \
--header 'Accept: <accept>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"jsonrpc": "2.0",
"method": "tools/list",
"params": {},
"id": 1
}
'{
"jsonrpc": "2.0",
"result": {
"tools": [
{
"name": "search_contacts",
"description": "Search the Seamless.AI database for contacts matching filters like company, title, seniority, and location. (Abbreviated; the generated Search tools page has the full text.)",
"inputSchema": {
"type": "object",
"properties": {
"companyName": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"outputSchema": {
"type": "object",
"required": [
"results"
],
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"pagination": {
"type": "object",
"additionalProperties": true
}
}
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
}
}
]
},
"id": 1
}Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Headers
Must include both application/json and text/event-stream.
"application/json, text/event-stream"
Body
JSON-RPC version. Always "2.0".
2.0 MCP method to invoke (e.g. "tools/list", "tools/call", "resources/read").
"tools/call"
Method-specific parameters. For tools/call, includes name (tool name) and arguments (tool input). For resources/read, includes uri.
Show child attributes
Show child attributes
Request ID for correlating responses. Omit it for notifications.
Response
JSON-RPC 2.0 response with the result or error.
"2.0"
Method-specific result payload. tools/call responses match McpToolCallResult.
- Option 1
- Option 2
Show child attributes
Show child attributes
JSON-RPC protocol error, such as an unknown method. Tool failures are returned in result with isError set to true.
Show child attributes
Show child attributes
Was this page helpful?
curl --request POST \
--url https://mcp.seamless.ai/mcp \
--header 'Accept: <accept>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"jsonrpc": "2.0",
"method": "tools/list",
"params": {},
"id": 1
}
'{
"jsonrpc": "2.0",
"result": {
"tools": [
{
"name": "search_contacts",
"description": "Search the Seamless.AI database for contacts matching filters like company, title, seniority, and location. (Abbreviated; the generated Search tools page has the full text.)",
"inputSchema": {
"type": "object",
"properties": {
"companyName": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"outputSchema": {
"type": "object",
"required": [
"results"
],
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"pagination": {
"type": "object",
"additionalProperties": true
}
}
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
}
}
]
},
"id": 1
}