Conectar via MCP

O MCP (Model Context Protocol) permite plugar a FonteData diretamente no seu assistente de IA (Claude, ChatGPT, Cursor e outros) e fazer consultas — e enviar SMS e códigos OTP de verificação — em linguagem natural, pelo chat, sem escrever código nem colar API Key.

A conexão é remota, via HTTPS, com login OAuth no navegador: você pluga a URL, faz login na sua conta FonteData, autoriza, e pronto.

Endpoint

https://app.fontedata.com/mcp

Adicione esse endereço como um conector / servidor MCP remoto no seu assistente. Ao conectar, o app abre uma janela de login da FonteData: entre com seu e-mail e senha e escolha o que deseja autorizar.

O que você autoriza

Na tela de consentimento você concede, separadamente:

• Ver suas consultas disponíveis — listar e descrever consultas, ações e preços. Não gasta saldo.
• Executar e enviar (gastar saldo) — rodar consultas e enviar SMS e códigos OTP. É uma permissão só: envio de mensagem sai do mesmo saldo pré-pago e passa pela mesma confirmação de custo que uma consulta.

Você pode autorizar só a primeira (modo somente-leitura) e habilitar a segunda depois.

As ferramentas disponíveis no chat

Além das consultas de dados, o servidor expõe ações de mensageria: enviar SMS e códigos OTP de verificação por telefone. As três primeiras ferramentas cobrem todo o catálogo; as três últimas são atalhos diretos para as ações de mensagem.

Ferramenta	O que faz	Custo
listar_consultas	Pesquisa e lista as consultas e ações disponíveis para a sua conta.	Grátis
descrever_consulta	Mostra os parâmetros, o preço e um exemplo de resposta de uma consulta.	Grátis
executar_consulta	Executa uma consulta ou uma ação pelo slug do catálogo. Mostra o custo e pede confirmação antes de gastar.	Gasta saldo
enviar_sms	Envia um SMS para um celular brasileiro (white-label). Cobrado por crédito de 160 caracteres.	Gasta saldo
enviar_otp	Envia um código OTP de verificação por SMS.	Gasta saldo
verificar_otp	Confere o código OTP que a pessoa digitou, usando o request_id devolvido por enviar_otp.	Grátis

A lista canônica vem de app.fontedata.com/api/v1/mcp/meta — é a auto-descrição do servidor, gerada a partir das ferramentas que ele realmente registra. Se esta tabela e o meta discordarem, o meta é que está certo.

O catálogo é sempre atualizado automaticamente: quando novas fontes de dados são adicionadas à API, elas aparecem no chat sem você precisar fazer nada.

Confirmação de custo

Toda execução é feita em duas etapas, para você nunca gastar sem querer — vale igual para uma consulta e para o envio de um SMS:

1. O assistente mostra quanto custa e o saldo que restará.
2. Você confirma e só então a consulta é executada (ou a mensagem enviada) e cobrada.

Sem saldo? Recarga pelo chat

Se o saldo for insuficiente, o assistente devolve um link de recarga que leva direto ao seu painel de recarga. Recarregue e volte ao chat para continuar a consulta.

Segurança

• Login via OAuth 2.1 com PKCE — sua senha nunca é compartilhada com o app de IA.
• O acesso é vinculado à sua conta e marca, e respeita seus limites e preços.
• As respostas passam pela mesma blindagem da API: nenhum dado de fornecedor é exposto.
• Você pode revogar o acesso a qualquer momento no painel.