MCP server CallNode
Commit 22 de out. de 2026Permite que assistentes de IA leiam o histórico de chamadas e mensagens, enviem SMS/MMS e façam ligações usando números de telefone da CallNode.
Também conhecido como cnchg/CallNode
- Stars
- 0
- Ferramentas
- 13
- Downloads, 30 dias
- —
- Versão mais recente
- 1.0.0
- Último commit
- 22 de out. de 2026
- Licença
- MIT
O que é o MCP CallNode?
Permite que assistentes de IA leiam o histórico de chamadas e mensagens, enviem SMS/MMS e façam ligações usando números de telefone da CallNode. Ele expõe 13 ferramentas, como list_numbers, get_number, list_calls.
Resumo gerado a partir do README do projeto
Sobre o MCP server de CallNode
A CallNode oferece um MCP server hospedado que conecta seus números de telefone CallNode diretamente a assistentes de IA. Essa configuração permite que os usuários integrem recursos de comunicação em plataformas como Claude Desktop, ChatGPT, Cursor e VS Code sem a necessidade de instalar software local. Ao fornecer uma URL de servidor e utilizar um processo de consentimento baseado em OAuth, você pode conceder permissão para um assistente interagir com números de telefone específicos que você selecionou em seu dashboard.
Uma vez conectado, o assistente pode realizar diversas tarefas de comunicação usando ferramentas como send_message, place_call e list_messages. Você pode gerenciar as permissões de forma granular, escolhendo se a IA pode ler o histórico, enviar SMS/MMS ou gerenciar sua agenda de contatos. O sistema inclui recursos de segurança, como um limite de envios por hora e restrições de horário, para garantir que mensagens e chamadas ocorram durante horários locais apropriados. Isso o torna uma solução prática para desenvolvedores que desejam automatizar tarefas de telefonia por meio de uma interface conversacional.
O que você pode fazer com ele
- 1Revisar histórico de comunicaçãoPeça ao seu assistente de IA para resumir interações recentes ou verificar o status de mensagens anteriores.
- 2Automatizar mensagens de saídaInstrua o assistente a enviar um texto ou uma imagem para um contato ou número de telefone específico.
- 3Executar chamadas de vozFaça com que a IA realize uma chamada telefônica usando um agente de voz para conduzir a conversa com base em suas instruções.
- 4Gerenciar listas de contatosUse o assistente para buscar nomes em sua agenda ou adicionar novos contatos ao seu diretório.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP CallNode
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP CallNode no Claude Code
$ claude mcp add --transport http callnode https://mcp.callnode.io/mcpInstalar o MCP CallNode no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"callnode": {
"url": "https://mcp.callnode.io/mcp"
}
}
}Instalar o MCP CallNode no VS Code
.vscode/mcp.json
{
"servers": {
"callnode": {
"type": "http",
"url": "https://mcp.callnode.io/mcp"
}
}
}Instalar o MCP CallNode no VS Code CLI
$ code --add-mcp '{"name":"callnode","type":"http","url":"https://mcp.callnode.io/mcp"}'Instalar o MCP CallNode no Codex
$ codex mcp add callnode --url https://mcp.callnode.io/mcpInstalar o MCP CallNode no Codex config.toml
~/.codex/config.toml
[mcp_servers.callnode] url = "https://mcp.callnode.io/mcp"
Instalar o MCP CallNode no Gemini CLI
$ gemini mcp add -s user --transport http callnode https://mcp.callnode.io/mcpInstalar o MCP CallNode no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"callnode": {
"url": "https://mcp.callnode.io/mcp",
"type": "http"
}
}
}Ferramentas do MCP CallNode 13
Detectadas a partir do READMElist_numbersget_numberlist_callsget_callplace_calllist_messagesget_messagesend_messagelist_phone_bookadd_phone_book_contactremove_phone_book_contactget_balance
| list_numbers | — | |
| get_number | — | |
| list_calls | — | |
| get_call | — | |
| place_call | — | |
| list_messages | — | |
| get_message | — | |
| send_message | — | |
| list_phone_book | — | |
| add_phone_book_contact | — | |
| remove_phone_book_contact | — | |
| get_balance | — |
Mostrar todas as 13 ferramentasMostrar menos ferramentas
get_updates
| get_updates | — |
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelcnchg/callnode is public and reachablegithub.com/cnchg/callnode ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-10-22github.com/cnchg/callnode ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPHTTPS endpoint answered 401 (sign-in required)Passou
README
Ver no GitHubCallNode MCP server
Your CallNode phone numbers, inside your AI assistant.
CallNode hosts a Model Context Protocol (MCP) server at:
https://mcp.callnode.io/mcp
Sign in to it from claude.ai, Claude Desktop, ChatGPT, Claude Code, Cursor or VS Code, then tick the numbers the assistant may use. It can then:
- read your call and message history;
- send texts and picture messages;
- call or text your Phone Book contacts by name;
- once you switch calling on, place calls that the CallNode voice agent runs.
The server is hosted by CallNode, so there is nothing to install or run. This repository holds only the connection details: client configs, the registry entry and this README.
- What it can do, in plain words: https://callnode.io/integrations/mcp
- Every tool, permission, limit and error code: https://callnode.io/docs/mcp
Before you connect
- Create an account at https://callnode.io/signup (no credit card to start) and get a number. Self-serve numbers are local and toll-free numbers in the US and Canada.
- Open Dashboard → MCP Server, switch MCP access on, and tick the numbers an assistant may use. Every connection shares this one list; a number you did not tick cannot be read from or sent from.
Connect
You give the client only the server URL. It sends you to the CallNode consent page, and you approve. No token is created, and nothing secret is pasted into a file or a shell.
On the consent page you can untick permissions (sending, for example), choose a live or test connection, and set an hourly send cap. Afterwards the connection appears under Dashboard → MCP Server, and you can revoke it there at any time.
claude.ai and Claude Desktop
- Open Settings → Connectors and choose Add custom connector.
- Enter
https://mcp.callnode.io/mcpas the server URL and continue. Leave the client id and secret fields empty. - Claude opens the CallNode sign-in page. Log in if asked, review the numbers and permissions, and approve.
- Back in Claude, enable the connector in a chat.
ChatGPT
- Enable Developer mode under Settings → Connectors → Advanced, then choose Create.
- Enter
https://mcp.callnode.io/mcpas the MCP server URL and pick OAuth for authentication. No client id or secret is needed, because ChatGPT registers itself. - Approve on the CallNode sign-in page, then add the connector to a chat.
Claude Code
Either use .mcp.json from this repository in your project, or run this once:
claude mcp add --transport http callnode https://mcp.callnode.io/mcp
Inside Claude Code, type /mcp, pick callnode and choose Authenticate. Approve in the browser.
VS Code (Copilot agent mode)
- Save
.vscode/mcp.jsonin your workspace, then start the callnode server. VS Code opens the CallNode consent page; approve. - In Copilot Chat, choose Agent mode and tick the callnode tools.
Cursor
- Save
.cursor/mcp.jsonin your project, or the same entry in~/.cursor/mcp.json, then reload Cursor. - In Settings → MCP the server shows Needs login. Click it and approve in the browser.
Without a browser sign-in
For automations where a browser sign-in isn't possible, create a token connection in the dashboard. The snippets for each client are at https://callnode.io/docs/mcp#clients.
Tools
Each tool is bound to a permission you grant. A connection without that permission does not see the tool at all.
| Tool | Permission | What it does |
|---|---|---|
list_numbers |
numbers:read |
The enabled numbers, with what each can do and whether it has its own voice agent. |
get_number |
numbers:read |
One enabled number. Never webhook addresses, routing or credentials. |
list_calls |
calls:read |
Call records on the enabled numbers, newest first. No transcripts. |
get_call |
calls:read |
One call record, including how it ended. For calls placed through MCP: the summary, outcome and transcript. |
place_call |
calls:place |
Place a call. The CallNode voice agent runs it from your instructions, or the number's own voice webhook does. Off by default. |
list_messages |
messages:read |
SMS/MMS history on the enabled numbers. |
get_message |
messages:read |
One message, with its delivery status. |
send_message |
messages:send |
Send a text or picture message, to a number or to a Phone Book contact by name. |
list_phone_book |
phonebook:read |
Your Phone Book: your own lines, with their labels. |
add_phone_book_contact |
phonebook:manage |
Prepares an entry and returns a link. Only you can certify and save it. |
remove_phone_book_contact |
phonebook:manage |
Removes a Phone Book entry. |
get_balance |
account:read |
Your prepaid balance and auto-recharge settings. |
get_updates |
messages:read |
New inbound texts (and calls, when the connection can read calls) since the last check, with an optional wait of up to 20 seconds. |
send_message and place_call are marked as actions that reach a person and cannot be undone (destructiveHint), so clients that honour tool hints ask you before running them.
Safety and limits
- Numbers. Only the numbers you tick are visible, and no token can widen that list.
- Same rules as the API. Sends and calls go through the same rules as the CallNode API:
- opt-outs and STOP replies are honoured;
- texts and calls fall inside 8am–9pm in the recipient's local time, except your own certified Phone Book lines;
- sending numbers must be registered for messaging;
- calls need business verification, and do-not-call lists, destination restrictions and your concurrent-call limit apply;
- your balance must cover each send.
- Per-connection limits:
- 30 sends an hour by default, settable from 1 to 200;
- an identical text to the same recipient within 60 seconds is sent once;
- 10 calls an hour, and the same from/to pair within 60 seconds is never dialled twice;
- 120 tool calls a minute.
- The voice agent introduces itself as an AI assistant calling on behalf of your business and never claims to be human. It cannot transfer a call or take card details.
- Untrusted content. Message bodies and caller-supplied text reach the assistant marked as untrusted, so a text that tries to give it instructions reads as data.
- Activity log. Every tool call, allowed or refused, appears under Recent activity in your dashboard. Message contents are never stored there.
- Revoking. A revoked connection is refused on its next request. A sign-in lapses after 90 days without a fresh one.
- Test connections run every rule, then simulate the send or the call. Nothing leaves the platform and nothing is charged.
Pricing
The MCP server has no fee. Texts and calls are billed from your prepaid balance at your normal rates, and calls the CallNode voice agent runs add a per-minute rate for the voice. All rates are on https://callnode.io/pricing.
Support
- Help: support@callnode.io
- Security reports: security@callnode.io
- Privacy: https://callnode.io/privacy
- Terms: https://callnode.io/terms
- Security: https://callnode.io/security
Files in this repository
| File | For |
|---|---|
server.json |
The Official MCP Registry entry (io.callnode/mcp) |
.mcp.json |
Claude Code |
.vscode/mcp.json |
VS Code |
.cursor/mcp.json |
Cursor |
These files are released under the MIT License. The CallNode service itself is covered by the CallNode Terms.
Perguntas sobre o MCP CallNode
Como adiciono o MCP CallNode ao Claude Code?
Execute claude mcp add --transport http callnode https://mcp.callnode.io/mcp no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP CallNode ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Quais ferramentas o MCP CallNode oferece?
Ele expõe 13 ferramentas, incluindo list_numbers, get_number, list_calls, get_call, place_call.
Como conecto o CallNode ao meu assistente de IA?
Você fornece a URL do servidor ao seu cliente, que o redirecionará para uma página de consentimento da CallNode para aprovar permissões e selecionar números de telefone específicos.
Existe alguma taxa para usar o MCP server?
O MCP server em si não possui taxa adicional, mas mensagens e chamadas são cobradas do seu saldo pré-pago da CallNode conforme as tarifas normais.
O assistente de IA pode fazer chamadas telefônicas?
Sim, uma vez que a função de chamadas esteja ativada, o assistente pode realizar ligações que serão gerenciadas pelo agente de voz da CallNode.