AI ایجنٹس کے لیے FinancialMD
FinancialMD agents کے لیے ایک AI-native مالیاتی ٹرمینل ہے۔ یہ SEC filings سے بنے مالیاتی بیانات فراہم کرتا ہے۔ ہر نمبر کے ساتھ فائلنگ تک پہنچنے والا ثبوت ہوتا ہے، اور ہر read ماضی کی کسی تاریخ کے مطابق کیا جا سکتا ہے، تاکہ agent اس کا حوالہ دے سکے اور look-ahead کے بغیر backtest کر سکے۔
مرحلہ 1۔ MCP سرور سے منسلک ہوں
MCP سرور https://mcp.financial.md/mcp پر ہے (Streamable HTTP، stateless)۔ اس میں 57 read-only tools ہیں۔ سائن اِن اختیاری ہے: بغیر token کے یہ keyless روزانہ کی حدود کے اندر جواب دیتا ہے۔
کلاؤڈ کوڈ:
claude mcp add --transport http financial-md https://mcp.financial.md/mcpوہ کلائنٹس جو JSON کنفیگریشن پڑھتے ہیں (کرسر، VS کوڈ، ونڈسرف اور دیگر):
{
"mcpServers": {
"financial-md": { "type": "http", "url": "https://mcp.financial.md/mcp" }
}
}Claude یا ChatGPT میں، یہی URL ایک custom connector کے طور پر شامل کریں۔ server card mcp.financial.md/.well-known/mcp.json پر ہے اور OAuth metadata mcp.financial.md/.well-known/oauth-protected-resource پر ہے۔
company_lookup سے شروع کریں، پھر snapshot_as_of (ایک ہی call میں تینوں بیانات اور کسی تاریخ تک معلوم ratios) یا financials_standardized استعمال کریں۔ verify_value استعمال کریں تاکہ آپ کہیں اور ملا ہوا نمبر چیک کر سکیں۔
مرحلہ 2۔ چابی کے بغیر API کال کریں
HTTP API کو نہ اکاؤنٹ چاہیے نہ key۔ یہ call Apple کے آخری پانچ سالانہ cash flow statements واپس کرتی ہے، جن میں فری کیش فلو بھی شامل ہے:
curl "https://api.financial.md/v1/company/financials/cash_flow/standardized?company=ticker:AAPL&period_type=annual&limit=5"ہر عدد ایک value object ہے جس میں 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 ایڈریس کو روزانہ 10 میٹرڈ کالز (تناسب، اسکرین، ویریفائی)، 1,000 فائلنگ لیئر ریڈز اور 1,000 میٹا ڈیٹا ریڈز ملتی ہیں۔ ہر جواب میں RateLimit-* ہیڈرز ہوتے ہیں؛ 429 میں Retry-After ہوتا ہے، اور ہر ایرر باڈی میں حل درج ہوتے ہیں۔
مرحلہ 3۔ فی کال ادائیگی
agent.financial.md ایجنٹس کے لیے وہی روٹس فراہم کرتا ہے جو بغیر اکاؤنٹ کے x402 (Base پر USDC) کے ساتھ فی کال ادائیگی کرتے ہیں۔ وہاں قیمت والا روٹ 402 میں PAYMENT-REQUIRED ہیڈر میں قیمت کے ساتھ جواب دیتا ہے؛ ادائیگی پر دستخط کریں اور کال کو دوبارہ PAYMENT-SIGNATURE ہیڈر کے ساتھ بھیجیں۔ 402 کا باڈی کی لیس ہوسٹ کا نام بھی بتاتا ہے، جہاں وہی روٹ روزانہ کی حدود کے اندر کبھی فیس نہیں لی جاتی۔
ہر روٹ کی قیمت pricing.json میں اور OpenAPI document کے x-price فیلڈ میں ہے۔ 402 جواب میں قیمت وہی ہے جو لاگو ہوتی ہے۔ اگر کال ناکام ہو جائے تو اس پر چارج نہیں کیا جاتا۔
ایجنٹس کے لیے فائلیں
| فائل | یہ کیا ہے |
|---|---|
| openapi.json | OpenAPI 3.1۔ ہر آپریشن کی ایک وضاحت اور ایک مثالی درخواست ہوتی ہے جس میں ایک حقیقی ٹکر ہوتا ہے |
| llms.txt | مختصر رہنما: hosts، company ids، value object، مخصوص وقت کے مطابق (point-in-time) reads، اور حدود |
| llms-full.txt | سب کچھ ایک ٹیکسٹ فائل میں: ہر روٹ، تناسب کا فارمولا اور طریقہ |
| skill.md | ایک ایجنٹ اسکل جس میں ایک کال کی ترکیبیں ہیں |
| skills.zip | ایجنٹ اسکلز (SKILL.md) جو MCP ٹولز کو کال کرتے ہیں، ایک زپ فائل میں |
| pricing.json | فی کال قیمتیں، روزانہ کی حدیں اور ادائیگی کی حالت |
| mcp.json | MCP سرور کارڈ: اوزار، تصدیق اور دستاویزات |
| server.json | MCP رجسٹری کا اندراج |
| agent.json | اوپر ہر اینڈ پوائنٹ اور دستاویز کا ایک انڈیکس |
ایک ایجنٹ کس چیز پر بھروسہ کر سکتا ہے
- ہر عدد کا ایک ماخذ ہوتا ہے: فائلنگ کا accession number، form، filing date، XBRL tag، اور 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۔ - کوریج: آج US ایکسچینج پر درج SEC فائلرز؛ US GAAP فائل کرنے والوں کے لیے معیاری بیانات۔ صرف معلومات، سرمایہ کاری کا مشورہ نہیں۔