opf-br-mcp: Skill for Claude Code

Consultar Open Finance Brasil

Use o MCP opf-br-mcp para reunir a evidência necessária à implementação, revisão ou consulta técnica, mesmo sem acesso a uma codebase. As ferramentas podem ter um prefixo definido pelo cliente; localize list_domains, search, get_item e refresh desse servidor. Se não estiverem disponíveis, informe a limitação; não simule resultados.

Escolher a fonte

1. Identifique no pedido e, quando houver, no código a API, a versão, o papel da instituição e a dúvida concreta. Se uma dessas informações mudar a resposta e não puder ser determinada, explicite a hipótese ou peça esclarecimento antes de decidir o contrato.
2. Chame list_domains quando o catálogo ainda não estiver no contexto. Escolha pelos descritivos e specVersion; não presuma que a maior versão cadastrada seja a mais recente publicada ou a usada pelo projeto.
3. Reconstrua os filtros aceitos unindo filters do domínio a filterSets[filterSet], quando presentes. live: true identifica consulta remota sem cache.

Para contratos HTTP, payloads e schemas, consulte *-openapi. Para condições de uso, transições e fluxos, consulte o domínio *-business-rules pareado da mesma API e major. Use os descritivos do catálogo para localizar convenções compartilhadas, guias, PCM e requisitos não funcionais quando pertinentes. Não carregue todas as famílias preventivamente.

Recuperar o mínimo suficiente

• Comece com search no domínio escolhido e limit: 5. Use um termo curto, path, nome de campo, estado ou código de erro. Nos domínios extraídos, query exige todos os termos nos campos indexados, por substring e sem distinguir acentos ou maiúsculas: uma pergunta longa ou um campo interno de detail pode não ser encontrado.
• Use apenas filtros anunciados. Eles se combinam em AND; não combine filtros de tipos incompatíveis, como method de endpoint e schema de componente. Faça buscas separadas.
• Leia matches, returned e os resumos. Se precisar continuar, some returned ao offset, mantendo a consulta; pare quando returned for zero ou atingir matches. Em live, esse total cobre os resultados obtidos da fonte, não necessariamente todos os existentes nela.
• Use get_item para os itens que sustentam a decisão. Copie o id exato e mantenha o mesmo domínio. Em OpenAPI, leia detail e siga os ids de refs apenas onde forem necessários; mantenha um conjunto de ids já visitados para evitar ciclos. Não monte ids a partir de paths ou nomes de schemas.
• Pare de recuperar quando tiver contrato, regra aplicável e referências suficientes para a alteração solicitada. Não percorra toda a spec nem todas as referências por padrão.