AI एजेंटों के लिए FinancialMD

चरण 1. MCP सर्वर से जुड़ें

MCP सर्वर https://mcp.financial.md/mcp पर है (स्ट्रीम करने योग्य HTTP, स्टेटलेस)। इसमें 50 केवल-पढ़ने वाले टूल हैं। साइन इन करना वैकल्पिक है: टोकन के बिना यह बिना-कुंजी वाली दैनिक सीमाओं के भीतर जवाब देता है।

Claude Code:

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

JSON कॉन्फ़िगरेशन पढ़ने वाले क्लाइंट (Cursor, VS Code, Windsurf और अन्य):

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

Claude या ChatGPT में, इसी URL को कस्टम कनेक्टर के रूप में जोड़ें। सर्वर कार्ड mcp.financial.md/.well-known/mcp.json पर और OAuth मेटाडेटा mcp.financial.md/.well-known/oauth-protected-resource पर है।

company_lookup से शुरू करें, फिर snapshot_as_of (एक कॉल में, किसी तारीख तक ज्ञात तीनों विवरण और अनुपात) या financials_standardized का उपयोग करें। कहीं और मिले आँकड़े की जाँच के लिए verify_value का उपयोग करें।

चरण 2. बिना कुंजी के API कॉल करें

HTTP API के लिए न खाते की ज़रूरत है, न कुंजी की। यह कॉल Apple के पिछले पाँच वार्षिक नकदी प्रवाह विवरण लौटाती है, जिनमें फ्री कैश फ्लो भी शामिल है:

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 पर फाइलिंग) होते हैं। उस तारीख तक ज्ञात जानकारी पढ़ने के लिए 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}'

कुंजी के बिना, हर IP पते को एक दिन में 25 मीटर्ड कॉल (अनुपात, स्क्रीनिंग, सत्यापन), 1,000 फाइलिंग-लेयर रीड और 1,000 मेटाडेटा रीड मिलती हैं। हर रिस्पॉन्स में RateLimit-* हेडर होते हैं; 429 में Retry-After होता है, और हर त्रुटि की बॉडी में समाधान के उपाय दिए जाते हैं।

चरण 3. प्रति कॉल भुगतान करें

agent.financial.md उन एजेंटों के लिए वही रूट उपलब्ध कराता है जो बिना खाते के x402 (Base पर USDC) से प्रति कॉल भुगतान करते हैं। वहाँ शुल्क वाले रूट का जवाब 402 होता है, जिसमें कीमत PAYMENT-REQUIRED हेडर में होती है; भुगतान पर हस्ताक्षर करें और PAYMENT-SIGNATURE हेडर के साथ कॉल दोबारा भेजें। 402 की बॉडी में बिना-कुंजी वाले होस्ट का नाम भी होता है, जहाँ वही रूट दैनिक सीमाओं के भीतर निःशुल्क है।

हर रूट की कीमत pricing.json में और OpenAPI दस्तावेज़ के x-price फ़ील्ड में है। 402 जवाब में दी गई कीमत ही लागू होती है। विफल कॉल का शुल्क नहीं लिया जाता।

एजेंटों के लिए फ़ाइलें

एजेंट किन बातों पर भरोसा कर सकता है

• हर संख्या का एक स्रोत है: फाइलिंग का एक्सेशन नंबर, फॉर्म, फाइलिंग की तारीख, XBRL टैग और sec.gov पर दस्तावेज़ का लिंक। GET /proof/{id} उसके पीछे के मूल तथ्यों को दिखाता है।
• पॉइंट-इन-टाइम: known.from और known.to बताते हैं कि प्रत्येक मान कब सबसे हाल में फाइल किया गया आंकड़ा था। as_of, original=true और history=true बाद की जानकारी का उपयोग किए बिना अतीत को पढ़ते हैं और पुनर्कथन दिखाते हैं।
• संक्षिप्त उत्तर: विवरण के लिए की गई कॉल केवल मांगी गई अवधियों को लौटाती है; MCP टूल के परिणामों में संरचित डेटा से पहले एक पंक्ति का सारांश होता है।
• टिकर, CIK या नाम: company=ticker:AAPL, company=cik:320193, या GET /v1/companies?q=Apple।
• कवरेज: आज किसी अमेरिकी एक्सचेंज पर सूचीबद्ध SEC फाइलिंग करने वाली कंपनियां; US GAAP के तहत फाइलिंग करने वाली कंपनियों के लिए मानकीकृत विवरण। केवल जानकारी, निवेश सलाह नहीं।