FinancialMD para agentes de IA
FinancialMD es un terminal financiero nativo de IA para agentes. Ofrece estados financieros elaborados a partir de presentaciones ante la SEC (documentos presentados). Cada cifra incluye una prueba que remite a la presentación ante la SEC (documento presentado), y cada lectura puede realizarse a una fecha pasada, para que un agente pueda citar lo que afirma y realizar pruebas retrospectivas sin sesgo de anticipación.
Paso 1. Conecta el servidor MCP
El servidor MCP está en https://mcp.financial.md/mcp (Streamable HTTP, sin estado). Tiene 50 herramientas de solo lectura. Iniciar sesión es opcional: sin un token, responde dentro de los límites diarios sin clave.
Claude Code:
claude mcp add --transport http financial-md https://mcp.financial.md/mcpClientes que leen una configuración JSON (Cursor, VS Code, Windsurf y otros):
{
"mcpServers": {
"financial-md": { "type": "http", "url": "https://mcp.financial.md/mcp" }
}
}En Claude o ChatGPT, añade la misma URL como conector personalizado. La ficha del servidor está en mcp.financial.md/.well-known/mcp.json y los metadatos de OAuth en mcp.financial.md/.well-known/oauth-protected-resource.
Empieza con company_lookup, seguido de snapshot_as_of (los tres estados financieros y los ratios tal como se conocían en una fecha, en una sola llamada) o financials_standardized. Usa verify_value para comprobar una cifra que hayas encontrado en otra fuente.
Paso 2. Realiza una llamada API sin clave
La API HTTP no requiere cuenta ni clave. Esta llamada devuelve los últimos cinco estados de flujos de efectivo anuales de Apple, incluido el flujo de caja libre:
curl "https://api.financial.md/v1/company/financials/cash_flow/standardized?company=ticker:AAPL&period_type=annual&limit=5"Cada cifra es un objeto de valor con proof.accession, proof.form, proof.filed y proof.source_url (la presentación ante la SEC (documento presentado) en sec.gov). Añade as_of=2024-06-30 para consultar lo que se conocía en esa fecha. Comprueba una cifra con la presentación ante la SEC (documento presentado):
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}'Sin clave, cada dirección IP dispone de 25 llamadas medidas al día (ratios, screen, verify), 1,000 lecturas de la capa de presentaciones ante la SEC (documentos presentados) y 1,000 lecturas de metadatos. Cada respuesta incluye encabezados RateLimit-*; una respuesta 429 incluye Retry-After, y el cuerpo de cada error enumera las medidas que se pueden tomar.
Paso 3. Paga por llamada
agent.financial.md ofrece las mismas rutas para los agentes que pagan por llamada con x402 (USDC en Base), sin cuenta. Allí, una ruta de pago responde con 402 e indica el precio en una cabecera PAYMENT-REQUIRED; firma el pago y vuelve a enviar la llamada con una cabecera PAYMENT-SIGNATURE. El cuerpo de la respuesta 402 también indica el host sin clave, donde la misma ruta es gratuita dentro de los límites diarios.
El precio de cada ruta figura en pricing.json y en el campo x-price del documento OpenAPI. El precio de la respuesta 402 es el que se aplica. Las llamadas fallidas no se cobran.
Archivos para agentes
| Archivo | Qué es |
|---|---|
| openapi.json | OpenAPI 3.1. Cada operación tiene una descripción y una solicitud de ejemplo con un símbolo bursátil real |
| llms.txt | Guía breve: hosts, identificadores de empresas, el objeto de valor, lecturas en un momento dado (point-in-time), límites |
| llms-full.txt | Todo en un archivo de texto: cada ruta, fórmula de ratio y receta |
| skill.md | Una habilidad de agente con recetas de una sola llamada |
| skills.zip | Habilidades de agente (SKILL.md) que llaman a las herramientas MCP, en un único archivo zip |
| pricing.json | Precios por llamada, límites gratuitos y estado del pago |
| mcp.json | Ficha del servidor MCP: herramientas, autenticación y documentos |
| server.json | La entrada del registro MCP |
| agent.json | Un índice de todos los endpoints y documentos anteriores |
En qué puede confiar un agente
- Cada cifra tiene una fuente: el número de registro, el formulario, la fecha de la presentación ante la SEC (documento presentado), la etiqueta XBRL y un enlace al documento en sec.gov.
GET /proof/{id}muestra los datos sin procesar que la sustentan. - En un momento dado (point-in-time):
known.fromyknown.toindican cuándo cada valor era la última cifra presentada.as_of,original=trueyhistory=truepermiten consultar el pasado sin incorporar información futura y muestran las reexpresiones. - Respuestas breves: una llamada de estados financieros devuelve solo los períodos solicitados; los resultados de las herramientas MCP comienzan con un resumen de una línea antes de los datos estructurados.
- Símbolo bursátil, CIK o nombre:
company=ticker:AAPL,company=cik:320193, oGET /v1/companies?q=Apple. - Cobertura: entidades que presentan información ante la SEC y cotizan actualmente en una bolsa estadounidense; estados financieros estandarizados para las entidades que presentan información conforme a US GAAP. Solo información, no asesoramiento de inversión.