MCP Tools
Boltly exposes its API as Model Context Protocol (MCP) tools so AI agents can send messages, manage contacts, and more. Tool availability is scoped to your API key's permissions.
GET
/v1/mcp/tools List tools
List the MCP tools available to your API key. Results are filtered by the scopes granted to the key.
Request
cURL
curl https://api.boltly.online/v1/mcp/tools \
-H "X-API-Key: $API_KEY"Response
JSON
{
"data": [
{
"name": "send_message",
"description": "Send a WhatsApp message to a contact",
"input_schema": {
"type": "object",
"properties": {
"to": { "type": "string" },
"body": { "type": "string" }
},
"required": ["to", "body"]
}
},
{
"name": "list_contacts",
"description": "List contacts in your organization",
"input_schema": { "type": "object", "properties": {} }
}
]
} POST
/v1/mcp/tools/call Call tool
Execute an MCP tool by name with the provided arguments. The tool must be within your API key's scopes.
Parameters
name string required Name of the tool to execute, as returned by List tools.
arguments object Tool arguments matching the tool's input_schema.
Request
cURL
curl -X POST https://api.boltly.online/v1/mcp/tools/call \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "send_message",
"arguments": {
"to": "+1234567890",
"body": "Hello from an MCP tool!"
}
}'Response
JSON
{
"data": {
"id": "msg_01H2X3K...",
"to": "+1234567890",
"status": "queued",
"created_at": "2026-04-03T12:00:00Z"
}
}