مواد پر جائیں

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.jsonOpenAPI 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.jsonMCP سرور کارڈ: اوزار، تصدیق اور دستاویزات
server.jsonMCP رجسٹری کا اندراج
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 فائل کرنے والوں کے لیے معیاری بیانات۔ صرف معلومات، سرمایہ کاری کا مشورہ نہیں۔