Servidor MCP do Memberfy (Streamable HTTP)
POST/mcp
- Auth
- Requires a token
Endpoint do Model Context Protocol para o Claude, o ChatGPT, o Cursor e qualquer cliente MCP. Corpo e resposta são JSON-RPC 2.0 (`initialize`, `tools/list`, `tools/call`…), sem sessão. Exige `Authorization: Bearer` com o access token do OAuth (`/oauth/token`); sem ele, 401 com `WWW-Authenticate` apontando para `/.well-known/oauth-protected-resource/mcp`. O token está preso a uma comunidade e o assistente age com o papel atual de quem conectou: as ferramentas chamam as mesmas rotas da API, com as mesmas regras. Dinheiro (cupom, preço, saque, cancelamento) pede confirmação em duas chamadas. Limite de 120 chamadas de ferramenta por minuto por conexão. Nomes de ferramentas e argumentos são identificadores em inglês (`snake_case`, ex.: `create_course`, `sales_report`); títulos, resumos e mensagens saem no idioma do membro conectado (senão o da comunidade, senão en-US). Respostas podem trazer `next_steps` (até três próximas ações que o papel pode executar), e o servidor expõe prompts prontos (`prompts/list`) conforme o papel. `serverInfo.version` é `<versão do pacote>+<commit curto>` e muda a cada deploy. O resultado de `initialize` e o de `tools/list` trazem `_meta.memberfy` com `server_version`, `tools_fingerprint` (hash curto dos nomes e dos esquemas de entrada da lista que esta conexão recebe) e `tool_count`; as instruções do servidor terminam com uma linha que repete a versão da lista. Chamar uma ferramenta fora da lista da conexão devolve um erro de ferramenta (`isError`) pedindo para a pessoa abrir uma nova conversa ou reconectar o conector; se o nome é um dos antigos em português, a resposta traz `renamed_to` com o nome novo.
Request body application/json
The specification does not declare the fields of this body (a multipart upload, for example). See the topic guide.
Responses
| Status | Description |
|---|---|
200 | Resposta JSON-RPC (fora do envelope da API). |
401 | Sem token, ou token inválido, vencido ou revogado. |
429 | Limite de requisições da conexão. |
curl example
curl -X POST "https://api.memberfy.net/mcp" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{}'