# bolsa_familia — how to use (mcp.ai)

Checks receipt of the Bolsa Família benefit by a beneficiary from the NIS and reference month/year. Platform-hosted, no credentials, pay per query with prepaid credit.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_bolsa_familia?ms=1787191440000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `bolsa_familia_consultar`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/bolsa_familia`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/bolsa_familia/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/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. Hospedado pela plataforma, sem credenciais, pague por consulta com crédito pré-pago. Consulta in
  - body: { Nis: string, MesReferencia: string, AnoReferencia: string, MesCompetencia: string, AnoCompetencia: string, completo?: boolean }

## Example prompts
- "Did NIS 12345678901 receive Bolsa Família in 06/2024?"
- "Bolsa Família for NIS 12345678901"

## More
- Page: https://mcp.ai/bolsa_familia
- Agent spec (llms.txt): https://mcp.ai/bolsa_familia/llms.txt
- Postman collection: https://mcp.ai/bolsa_familia/postman.json