Endpoint MCP

POSThttps://livetp.app/mcp

O servidor MCP recebe mensagens JSON-RPC 2.0 por POST, conforme o transporte Streamable HTTP do Model Context Protocol. Normalmente, um cliente MCP cuida disso para você. Esta página é útil para depuração e integrações próprias.

Autentique com OAuth ou com uma chave MCP (ltp_mcp_…). Chaves ltp_api_… não são aceitas. Veja o Servidor MCP e a referência das ferramentas.

Headers

Authorizationstringheaderobrigatório

Bearer <token OAuth ou chave MCP>.

Content-Typestringheaderobrigatório

application/json.

Acceptstringheaderobrigatório

application/json, text/event-stream.

MCP-Protocol-Versionstringheader

Versão do protocolo negociada, como 2026-07-28 ou 2025-11-25.

Métodos principais

Método	Uso
`initialize`	Negocia versão e capacidades. O servidor se chama `livetp`.
`tools/list`	Lista as ferramentas permitidas pelos escopos da conexão.
`tools/call`	Executa uma ferramenta com `name` e `arguments`.

Respostas HTTP

Status	Quando
`200`	Resposta JSON-RPC (em JSON ou em um stream SSE dentro da mesma requisição).
`401`	Credencial ausente ou inválida. Inclui `WWW-Authenticate` com `resource_metadata`.
`403`	Origem ou host não permitidos, ou escopo insuficiente (`error="insufficient_scope"`).
`405`	`GET` ou `DELETE` de sessão legada.
`429`	Limite de requisições da conta.

Erros de ferramenta (como conflict ou not_found) não mudam o status HTTP: chegam no resultado com isError: true.

Requisição

curl 'https://livetp.app/mcp' \
  -H "Authorization: Bearer $LIVETP_MCP_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Resposta

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      { "type": "text", "text": "{\"script\":{\"id\":\"b1c2...\",\"revision\":1}}" }
    ],
    "structuredContent": {
      "script": {
        "id": "b1c2d3e4-f5a6-4b7c-8d9e-0f1a2b3c4d5e",
        "title": "Teaser de 30 segundos",
        "content": "Você já tentou gravar sem decorar?",
        "status": "draft",
        "revision": 1,
        "createdAt": "2026-10-30T15:00:00.000Z",
        "updatedAt": "2026-10-30T15:00:00.000Z",
        "deletedAt": null
      }
    }
  }
}

Endpoint MCP

HeadersCopiar link da seção

Métodos principaisCopiar link da seção

Respostas HTTPCopiar link da seção

Headers

Métodos principais

Respostas HTTP