AI एजंट्ससाठी FinancialMD
FinancialMD हे एजंटसाठी AI-native financial terminal आहे. ते SEC फायलिंग्जमधून तयार केलेली financial statements पुरवते. प्रत्येक संख्येसोबत फायलिंगपर्यंत मागोवा घेणारा पुरावा असतो, आणि प्रत्येक read भूतकाळातील कोणत्याही तारखेप्रमाणे करता येतो, त्यामुळे एजंट जे सांगतो त्याचा संदर्भ देऊ शकतो आणि look-ahead शिवाय backtest करू शकतो.
चरण 1. MCP सर्व्हर कनेक्ट करा
MCP सर्व्हर https://mcp.financial.md/mcp वर आहे (स्ट्रीम करण्यायोग्य HTTP, स्टेटलेस). यात 57 वाचन-केवळ साधने आहेत. साइन इन करणे पर्यायी आहे: टोकनशिवाय ते कीलेस दैनंदिन मर्यादेत उत्तर देते.
क्लॉड कोड:
claude mcp add --transport http financial-md https://mcp.financial.md/mcpJSON config वाचणारे clients (Cursor, VS Code, Windsurf आणि इतर):
{
"mcpServers": {
"financial-md": { "type": "http", "url": "https://mcp.financial.md/mcp" }
}
}Claude किंवा ChatGPT मध्ये, तोच URL custom connector म्हणून जोडा. सर्व्हर कार्ड mcp.financial.md/.well-known/mcp.json वर आहे आणि OAuth metadata mcp.financial.md/.well-known/oauth-protected-resource वर आहे.
company_lookup ने सुरुवात करा, नंतर snapshot_as_of (तिन्ही विवरणे आणि त्या तारखेला ज्ञात असलेली गुणोत्तरे, एका कॉलमध्ये) किंवा financials_standardized. तुम्हाला इतरत्र सापडलेला आकडा तपासण्यासाठी verify_value वापरा.
चरण 2. कीलेस API कॉल करा
HTTP API साठी खाते किंवा की लागत नाही. हा कॉल Apple चे शेवटचे पाच वार्षिक cash flow statements परत करतो, ज्यात फ्री कॅश फ्लो समाविष्ट आहे:
curl "https://api.financial.md/v1/company/financials/cash_flow/standardized?company=ticker:AAPL&period_type=annual&limit=5"प्रत्येक संख्या proof.accession, proof.form, proof.filed आणि proof.source_url (sec.gov वरील फायलिंग) असलेला value object आहे. त्या तारखेला काय ज्ञात होते ते वाचण्यासाठी as_of=2024-06-30 जोडा. फायलिंगशी एखादी संख्या पडताळा:
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}'key शिवाय, प्रत्येक IP address ला दिवसाला 10 metered calls (ratios, screen, verify), 1,000 फायलिंग-स्तर वाचने आणि 1,000 metadata वाचने मिळतात. प्रत्येक response सोबत RateLimit-* headers असतात; 429 सोबत Retry-After असते, आणि प्रत्येक error body मध्ये उपायांची यादी असते.
चरण 3. प्रति कॉल पैसे द्या
agent.financial.md खाते नसतानाही x402 (USDC on Base) द्वारे प्रति कॉल पैसे देणाऱ्या एजंट्ससाठी तेच routes देते. तेथील किंमत असलेला route PAYMENT-REQUIRED header मध्ये किंमत देऊन 402 उत्तर देतो; payment वर स्वाक्षरी करा आणि PAYMENT-SIGNATURE header सह पुन्हा call पाठवा. 402 च्या body मध्ये keyless host चे नावही असते, जिथे तोच route दैनंदिन मर्यादेत कधीही शुल्क आकारले जात नाही.
प्रत्येक route ची किंमत pricing.json मध्ये आणि OpenAPI document मधील x-price field मध्ये आहे. 402 उत्तरातील किंमत लागू होते. अयशस्वी झालेल्या call वर शुल्क आकारले जात नाही.
एजंट्ससाठी फायली
| फाईल | ते काय आहे |
|---|---|
| openapi.json | OpenAPI 3.1 आहे. प्रत्येक ऑपरेशनमध्ये वास्तविक टिकरसह वर्णन आणि एक उदाहरण विनंती असते |
| llms.txt | लहान मार्गदर्शक: hosts, company ids, value object, पॉइंट-इन-टाइम reads, limits |
| llms-full.txt | एका मजकूर फाइलमध्ये सर्वकाही: प्रत्येक route, ratio formula आणि recipe |
| skill.md | one-call recipes असलेले Agent Skill |
| skills.zip | MCP tools ला कॉल करणारी Agent Skills (SKILL.md), एका zip मध्ये |
| pricing.json | प्रति-कॉल किंमत, दैनंदिन मर्यादा आणि देयक स्थिती |
| mcp.json | MCP सर्व्हर कार्ड: साधने, प्रमाणीकरण आणि दस्तऐवज |
| server.json | MCP Registry entry |
| agent.json | वरील प्रत्येक endpoint आणि document ची एक index |
एजंट कशावर अवलंबून राहू शकतो
- प्रत्येक संख्येला एक स्रोत असतो: फायलिंगचा accession number, form, filing date, XBRL tag आणि sec.gov वरील document ची link.
GET /proof/{id}त्यामागील कच्चे facts दाखवते. - पॉइंट-इन-टाइम:
known.fromआणिknown.toसांगतात की प्रत्येक value केव्हा नवीनतम फायल केलेला आकडा होता.as_of,original=trueआणिhistory=trueपुढे न पाहता भूतकाळ वाचतात आणि सुधारित आकडे दाखवतात. - संक्षिप्त उत्तरे: statement call फक्त मागितलेले periods परत करतो; MCP tool results structured data च्या आधी एका ओळीच्या summary ने सुरू होतात.
- टिकर, CIK किंवा नाव:
company=ticker:AAPL,company=cik:320193, किंवाGET /v1/companies?q=Apple. - कव्हरेज: आज US exchange वर सूचीबद्ध SEC filers; US GAAP filers साठी standardized statements. फक्त माहिती, गुंतवणुकीचा सल्ला नाही.