Servidor MCP Streamable HTTP
Ferramentas: list_instances, get_instance_status, send_text, send_media, list_groups, group_metadata, mark_read, queue_status e webhook_deliveries.
curl -X POST "https://seu-dominio/mcp" \
-H "x-api-key: $VERTICE_API_KEY" \
-H "accept: application/json, text/event-stream" \
-H "content-type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'const response = await fetch('https://seu-dominio/mcp', {
method: 'POST',
headers: {
'x-api-key': process.env.VERTICE_API_KEY ?? '',
'content-type': 'application/json',
accept: 'application/json, text/event-stream',
},
body: JSON.stringify({
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}),
});
const payload = await response.json();
console.log(payload);Conceituação
Ferramentas: list_instances, get_instance_status, send_text, send_media, list_groups, group_metadata, mark_read, queue_status e webhook_deliveries. Envie JSON-RPC com initialize, notifications/initialized e tools/list.
A sessão MCP é negociada via initialize e mantida pelo header Mcp-Session-Id. Ferramentas de escrita exigem uma API key com escopo write.
Atributos
Header
x-api-key
string
obrigatório
API key do workspace (vtc_live_...). Também aceita Authorization: Bearer.
content-type
string
obrigatório
application/json.
accept
string
obrigatório
application/json, text/event-stream.
Body
jsonrpc
string
obrigatório
Versão do protocolo JSON-RPC. Use 2.0.
id
integer
opcional
Campo id do corpo JSON.
method
string
obrigatório
Método JSON-RPC, por exemplo initialize, tools/list ou tools/call.
params
object
opcional
Campo params do corpo JSON.
Request Body
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}Resposta
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"tools": [
{
"name": "list_instances"
},
{
"name": "send_text"
}
]
}
}Este endpoint segue o formato JSON-RPC, sem envelope data.