MCP
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.
POST
/
mcp
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
OAuth2ApiKey
Headers
Body
application/json
Response
JSON-RPC 2.0 response with the result or error.
Was this page helpful?
⌘I
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
}