FinancialMD pour les agents IA
FinancialMD est un terminal financier conçu nativement pour l'IA et destiné aux agents. Il fournit des états financiers construits à partir de dépôts auprès de la SEC (documents déposés). Chaque chiffre est accompagné d'une preuve qui renvoie au dépôt auprès de la SEC (document déposé), et chaque lecture peut être effectuée à une date passée : un agent peut ainsi citer ses sources et réaliser des tests rétrospectifs sans biais d'anticipation.
Étape 1. Connecter le serveur MCP
Le serveur MCP se trouve à l'adresse https://mcp.financial.md/mcp (Streamable HTTP, sans état). Il dispose de 50 outils en lecture seule. La connexion est facultative : sans jeton, il répond dans les limites quotidiennes sans clé.
Claude Code :
claude mcp add --transport http financial-md https://mcp.financial.md/mcpClients qui lisent une configuration JSON (Cursor, VS Code, Windsurf et autres) :
{
"mcpServers": {
"financial-md": { "type": "http", "url": "https://mcp.financial.md/mcp" }
}
}Dans Claude ou ChatGPT, ajoutez la même URL comme connecteur personnalisé. La fiche du serveur se trouve à mcp.financial.md/.well-known/mcp.json et les métadonnées OAuth à mcp.financial.md/.well-known/oauth-protected-resource.
Commencez par company_lookup, puis utilisez snapshot_as_of (les trois états financiers et les ratios tels qu'ils étaient connus à une date donnée, en un seul appel) ou financials_standardized. Utilisez verify_value pour vérifier un chiffre trouvé ailleurs.
Étape 2. Effectuer un appel API sans clé
L'API HTTP ne nécessite ni compte ni clé. Cet appel renvoie les cinq derniers tableaux des flux de trésorerie annuels d'Apple, y compris le flux de trésorerie disponible :
curl "https://api.financial.md/v1/company/financials/cash_flow/standardized?company=ticker:AAPL&period_type=annual&limit=5"Chaque chiffre est un objet valeur doté de proof.accession, proof.form, proof.filed et proof.source_url (le dépôt auprès de la SEC (document déposé) sur sec.gov). Ajoutez as_of=2024-06-30 pour consulter ce qui était connu à cette date. Vérifiez un chiffre par rapport au dépôt auprès de la SEC (document déposé) :
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}'Sans clé, chaque adresse IP bénéficie de 25 appels décomptés par jour (ratios, filtrage, vérification), de 1,000 lectures de la couche des dépôts auprès de la SEC (documents déposés) et de 1,000 lectures de métadonnées. Chaque réponse contient des en-têtes RateLimit-* ; une réponse 429 contient Retry-After, et chaque corps d'erreur énumère les mesures à prendre.
Étape 3. Payer à l'appel
agent.financial.md propose les mêmes routes aux agents qui paient à l'appel avec x402 (USDC sur Base), sans compte. Une route payante y renvoie une réponse 402 avec le prix dans un en-tête PAYMENT-REQUIRED ; signez le paiement et renvoyez l'appel avec un en-tête PAYMENT-SIGNATURE. Le corps de la réponse 402 indique également l'hôte sans clé, où la même route est gratuite dans les limites quotidiennes.
Le prix de chaque route figure dans pricing.json et dans le champ x-price du document OpenAPI. Le prix indiqué dans la réponse 402 est celui qui s'applique. Un appel qui échoue n'est pas facturé.
Fichiers pour les agents
| Fichier | Description |
|---|---|
| openapi.json | OpenAPI 3.1. Chaque opération possède une description et un exemple de requête avec un symbole boursier réel |
| llms.txt | Guide succinct : hôtes, identifiants des sociétés, objet valeur, lectures à date (point-in-time), limites |
| llms-full.txt | Tout dans un seul fichier texte : chaque route, formule de ratio et procédure |
| skill.md | Une compétence d'agent avec des procédures en un seul appel |
| skills.zip | Des compétences d'agent (SKILL.md) qui appellent les outils MCP, regroupées dans une archive zip |
| pricing.json | Prix par appel, limites gratuites et statut des paiements |
| mcp.json | Fiche du serveur MCP : outils, authentification et documents |
| server.json | L'entrée du registre MCP |
| agent.json | Un index de tous les points de terminaison et documents ci-dessus |
Ce sur quoi un agent peut s'appuyer
- Chaque chiffre a une source : le numéro d'accès du dépôt auprès de la SEC (document déposé), le formulaire, la date du dépôt auprès de la SEC (document déposé), la balise XBRL et un lien vers le document sur sec.gov.
GET /proof/{id}affiche les données brutes qui le sous-tendent. - À date (point-in-time) :
known.frometknown.toindiquent quand chaque valeur était le dernier chiffre déposé.as_of,original=trueethistory=truepermettent de consulter le passé sans biais d'anticipation et affichent les retraitements. - Réponses courtes : un appel aux états financiers ne renvoie que les périodes demandées ; les résultats des outils MCP commencent par un résumé d'une ligne avant les données structurées.
- Symbole boursier, CIK ou nom :
company=ticker:AAPL,company=cik:320193ouGET /v1/companies?q=Apple. - Couverture : sociétés déposant auprès de la SEC et actuellement cotées sur une bourse américaine ; états financiers standardisés pour celles qui publient selon les US GAAP. À titre informatif uniquement, ne constitue pas un conseil en investissement.