FinancialMD para agentes de IA

FinancialMD é um terminal financeiro nativo de IA para agentes. Ele fornece demonstrações financeiras construídas a partir de documentos arquivados na SEC. Cada número traz uma prova que remete ao documento arquivado na SEC, e toda consulta pode usar uma data passada como referência, permitindo que um agente cite suas afirmações e faça backtests sem usar informações futuras.

Etapa 1. Conecte o servidor MCP

O servidor MCP está em https://mcp.financial.md/mcp (Streamable HTTP, sem estado). Ele tem 50 ferramentas somente de leitura. A autenticação é opcional: sem um token, ele responde dentro dos limites diários sem chave.

Claude Code:

claude mcp add --transport http financial-md https://mcp.financial.md/mcp

Clientes que leem uma configuração JSON (Cursor, VS Code, Windsurf e outros):

{
  "mcpServers": {
    "financial-md": { "type": "http", "url": "https://mcp.financial.md/mcp" }
  }
}

No Claude ou no ChatGPT, adicione a mesma URL como um conector personalizado. O cartão do servidor está em mcp.financial.md/.well-known/mcp.json e os metadados OAuth em mcp.financial.md/.well-known/oauth-protected-resource.

Comece com company_lookup, depois use snapshot_as_of (as três demonstrações e os indicadores conforme conhecidos em uma data, em uma única chamada) ou financials_standardized. Use verify_value para conferir um número que você encontrou em outra fonte.

Etapa 2. Faça uma chamada à API sem chave

A API HTTP não exige conta nem chave. Esta chamada retorna as últimas cinco demonstrações anuais dos fluxos de caixa da Apple, incluindo o fluxo de caixa livre:

curl "https://api.financial.md/v1/company/financials/cash_flow/standardized?company=ticker:AAPL&period_type=annual&limit=5"

Cada número é um objeto de valor com proof.accession, proof.form, proof.filed e proof.source_url (o documento arquivado na SEC em sec.gov). Adicione as_of=2024-06-30 para consultar o que era conhecido naquela data. Confira um número com o documento arquivado na SEC:

curl -X POST "https://api.financial.md/v1/verify" -H "content-type: application/json" \
  -d '{"company":"ticker:AAPL","concept":"income_statement_total_revenues","period":"FY2024","value":391035000000}'

Sem chave, cada endereço IP tem direito a 25 chamadas contabilizadas por dia (ratios, screen, verify), 1,000 consultas à camada de documentos arquivados na SEC e 1,000 consultas a metadados. Toda resposta traz cabeçalhos RateLimit-*; uma resposta 429 traz Retry-After, e o corpo de todo erro lista ações corretivas.

Etapa 3. Pague por chamada

agent.financial.md disponibiliza as mesmas rotas para agentes que pagam por chamada com x402 (USDC na Base), sem conta. Uma rota com preço definido nesse host responde com 402 e o preço em um cabeçalho PAYMENT-REQUIRED; assine o pagamento e envie a chamada novamente com um cabeçalho PAYMENT-SIGNATURE. O corpo da resposta 402 também informa o host sem chave, onde a mesma rota é gratuita dentro dos limites diários.

O preço de cada rota está em pricing.json e no campo x-price do documento OpenAPI. O preço na resposta 402 é o que se aplica. Uma chamada que falha não é cobrada.

Arquivos para agentes

Arquivo	O que é
openapi.json	OpenAPI 3.1. Cada operação tem uma descrição e um exemplo de requisição com um ticker real
llms.txt	Guia breve: hosts, IDs de empresas, o objeto de valor, consultas na data de referência (point-in-time), limites
llms-full.txt	Tudo em um único arquivo de texto: todas as rotas, fórmulas de indicadores e receitas
skill.md	Uma habilidade de agente com receitas de chamada única
skills.zip	Habilidades de agente (SKILL.md) que chamam as ferramentas MCP, em um único zip
pricing.json	Preços por chamada, limites gratuitos e status de pagamento
mcp.json	Cartão do servidor MCP: ferramentas, autenticação e documentos
server.json	O registro no MCP Registry
agent.json	Um índice de todos os endpoints e documentos acima

Com o que um agente pode contar

Todo número tem uma fonte: o número de acesso do documento arquivado na SEC, o formulário, a data de arquivamento, a tag XBRL e um link para o documento em sec.gov. GET /proof/{id} mostra os fatos brutos por trás dele.
Na data de referência (point-in-time): known.from e known.to indicam quando cada valor era o dado mais recente arquivado. as_of, original=true e history=true consultam o passado sem usar informações futuras e mostram reapresentações.
Respostas curtas: uma chamada de demonstração retorna apenas os períodos solicitados; os resultados das ferramentas MCP começam com um resumo de uma linha antes dos dados estruturados.
Ticker, CIK ou nome: company=ticker:AAPL, company=cik:320193 ou GET /v1/companies?q=Apple.
Cobertura: empresas que arquivam documentos na SEC e estão listadas hoje em uma bolsa dos EUA; demonstrações padronizadas para empresas que reportam segundo US GAAP. Apenas informações, não constitui recomendação de investimento.