picpay-mcp

PicPay MCP — REST API skill

Você tem acesso à PicPay MCP REST API na MCP.AI.

Conecte sua conta do PicPay ao Claude, ChatGPT e agentes de IA via Open Finance Brasil. Pergunte sobre saldos, extratos, faturas de cartão e investimentos do PicPay em linguagem natural. Regulado pelo Banco Central, somente leitura.

Base URL

https://api.mcp.ai/api/openfinance

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/openfinance/connectors/search \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"keywords":"..."}'

Reportar problemas

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

Endpoints (16)

openfinance_search_bank_connectors

Buscar conectores de banco (Open Finance/API) por nome (POST /api/openfinance/connectors/search)

Parâmetro	Tipo	Obrigatório	Descrição
keywords	string[]	Sim	Termos do nome/id do banco (match OR), ex.: ['nubank','btg']. Obrigatório.
include_accounts	boolean	Não	Inclui contas (e contagem) de cada conexão já ligada. Custa 1 chamada por conexão; default false.

openfinance_list_connections

Listar bancos conectados (POST /api/openfinance/connections/list)

openfinance_get_item_status

Status de uma conexão (UPDATED, LOGIN_ERROR…) (POST /api/openfinance/connections/status)