bolsa_familia-mcp

Bolsa Família — REST API skill

Você tem acesso à Bolsa Família REST API na MCP.AI.

Verifica o recebimento do Bolsa Família por um beneficiário a partir do NIS e do mês/ano de referência. Hospedado pela plataforma, sem credenciais, pague por consulta com crédito pré-pago.

Base URL

https://api.mcp.ai/api/bolsa_familia

Todo endpoint é um POST na Base URL + o path abaixo. Os parâmetros vão no corpo JSON.

Autenticação

Inclua em toda request:

Authorization: Bearer sk_live_...
Content-Type: application/json

Gere sua chave em https://app.mcp.ai/settings/api-keys (workspace API key sk_live_…, não expira, revogável). Uma única chave serve pra todos os seus MCPs.

Formato de resposta

{ "ok": true, "tool": "<tool_id>", "result": <payload> }

Exemplo cURL

curl -X POST https://api.mcp.ai/api/bolsa_familia/consultar \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"Nis":"...","MesReferencia":"...","AnoReferencia":"...","MesCompetencia":"...","AnoCompetencia":"..."}'

Reportar problemas

Se um endpoint retornar erro, vazio ou dado inesperado, reporte (não desista calado): POST /api/bolsa_familia/report com { "message": "...", "context"?: "...", "conversation"?: [...] }. Isso notifica o time da MCP.AI.

Endpoints (1)

bolsa_familia_consultar

Verifica o recebimento do Bolsa Família por um beneficiário a partir do NIS e do mês/ano de referência. (POST /api/bolsa_familia/consultar)

Parâmetro	Tipo	Obrigatório	Descrição
Nis	string	Sim	Parâmetro de consulta "Nis".
MesReferencia	string	Sim	Parâmetro de consulta "MesReferencia".
AnoReferencia	string	Sim	Parâmetro de consulta "AnoReferencia".
MesCompetencia	string	Sim	Parâmetro de consulta "MesCompetencia".
AnoCompetencia	string	Sim	Parâmetro de consulta "AnoCompetencia".
completo	boolean	Não	Opcional. Por padrão (false) listas longas vêm resumidas aos primeiros itens, com a contagem total preservada. Use true para a resposta COMPLETA na mesma consulta.