সামগ্রীতে যান

AI এজেন্টদের জন্য FinancialMD

FinancialMD এজেন্টদের জন্য একটি AI-native আর্থিক টার্মিনাল। এটি SEC filing থেকে তৈরি আর্থিক বিবরণী দেয়। প্রতিটি সংখ্যার সঙ্গে filing-এ ফেরত যাওয়ার মতো প্রমাণ থাকে, এবং প্রতিটি read অতীতের কোনও তারিখ অনুযায়ী করা যায়, যাতে এজেন্ট যা বলছে তা উদ্ধৃত করতে পারে এবং look-ahead ছাড়া backtest করতে পারে।

ধাপ 1. MCP server সংযুক্ত করুন

MCP serverটি https://mcp.financial.md/mcp-এ আছে (Streamable HTTP, stateless)। এতে 57টি read-only tool আছে। সাইন-ইন করা ঐচ্ছিক: token ছাড়া এটি keyless daily limit-এর মধ্যে উত্তর দেয়।

ক্লড কোড:

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

যে ক্লায়েন্টগুলো JSON config পড়ে (Cursor, VS Code, Windsurf এবং অন্যান্য):

{
  "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-এ একটি তারিখ অনুযায়ী তিনটি statement এবং ratio) বা financials_standardized। অন্য কোথাও পাওয়া কোনও সংখ্যা পরীক্ষা করতে verify_value ব্যবহার করুন।

ধাপ 2. একটি keyless API call করুন

HTTP API-এর জন্য কোনও account বা key লাগে না। এই callটি 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-এ থাকা ফাইলিং) সহ একটি 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}'

একটি কী ছাড়াই, প্রতিটি IP ঠিকানা দিনে 10টি মিটারভিত্তিক কল পায় (অনুপাত, স্ক্রিন, যাচাই), 1,000 ফাইলিং-লেয়ার রিড এবং 1,000 মেটাডেটা রিড। প্রতিটি প্রতিক্রিয়ায় RateLimit-* হেডার থাকে; 429-এ Retry-After থাকে, এবং প্রতিটি ত্রুটির বডিতে প্রতিকারের তালিকা থাকে।

ধাপ 3। প্রতি কলের জন্য পরিশোধ করুন

agent.financial.md x402 (Base-এ USDC) দিয়ে প্রতি কলের জন্য পরিশোধ করা এজেন্টদের জন্য, কোনও অ্যাকাউন্ট ছাড়াই, একই রুট পরিবেশন করে। সেখানে একটি মূল্যযুক্ত রুট PAYMENT-REQUIRED হেডারে মূল্যসহ 402 ফেরত দেয়; পেমেন্টে স্বাক্ষর করুন এবং PAYMENT-SIGNATURE হেডার দিয়ে আবার কল পাঠান। 402-এর বডিতে কী-ছাড়া হোস্টের নামও থাকে, যেখানে একই রুটটি দৈনিক সীমার মধ্যে কখনও চার্জ নেওয়া হয় না।

প্রতিটি রুটের মূল্য pricing.json-এ এবং OpenAPI document-এর x-price ফিল্ডে আছে। 402 উত্তরের মূল্যটিই প্রযোজ্য। যে কল ব্যর্থ হয়, তার জন্য চার্জ করা হয় না।

এজেন্টদের জন্য ফাইল

ফাইলএটি কী
openapi.jsonOpenAPI 3.1. প্রতিটি অপারেশনের একটি বিবরণ এবং একটি বাস্তব টিকার সহ একটি উদাহরণ অনুরোধ থাকে
llms.txtসংক্ষিপ্ত গাইড: হোস্ট, কোম্পানির আইডি, value object, পয়েন্ট-ইন-টাইম রিড, সীমা
llms-full.txtএকটি টেক্সট ফাইলে সবকিছু: প্রতিটি রুট, অনুপাতের সূত্র এবং রেসিপি
skill.mdওয়ান-কল রেসিপি সহ একটি এজেন্ট দক্ষতা
skills.zipMCP টুলগুলোকে কল করে এমন এজেন্ট স্কিলস (SKILL.md), এক জিপে
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 ফাইলারদের জন্য মানসম্মত বিবৃতি। কেবল তথ্য, বিনিয়োগের পরামর্শ নয়।