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