FinancialMD لوكلاء الذكاء الاصطناعي

الخطوة 1. اربط خادم MCP

يوجد خادم MCP على https://mcp.financial.md/mcp (Streamable 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 (المستند المودَع) على sec.gov). أضف as_of=2024-06-30 لقراءة ما كان معلومًا في ذلك التاريخ. تحقّق من رقم بمقارنته بالإيداع لدى SEC (المستند المودَع):

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 عملية قراءة لطبقة الإيداع لدى SEC (المستند المودَع)، و1,000 عملية قراءة للبيانات الوصفية. يتضمن كل رد ترويسات RateLimit-*؛ ويتضمن رد 429 الترويسة Retry-After، ويسرد متن كل خطأ الإجراءات التصحيحية.

الخطوة 3. ادفع لكل استدعاء

يتيح agent.financial.md المسارات نفسها للوكلاء الذين يدفعون لكل استدعاء باستخدام x402 (USDC على Base)، دون حساب. يستجيب المسار المدفوع هناك بالرمز 402 مع السعر في ترويسة PAYMENT-REQUIRED؛ وقّع الدفع وأرسل الاستدعاء مجددًا مع ترويسة PAYMENT-SIGNATURE. ويذكر محتوى استجابة 402 أيضًا اسم المضيف الذي لا يتطلب مفتاحًا، حيث يكون المسار نفسه مجانيًا ضمن الحدود اليومية.

سعر كل مسار مذكور في pricing.json وفي حقل x-price من مستند OpenAPI. السعر الوارد في استجابة 402 هو السعر المطبّق. لا تُفرض رسوم على الاستدعاء الذي يفشل.

ملفات للوكلاء

ما يمكن للوكيل الاعتماد عليه

• لكل رقم مصدر: رقم الوصول الخاص بالإيداع لدى SEC (المستند المودَع)، والنموذج، وتاريخ الإيداع لدى SEC (المستند المودَع)، ووسم 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. للمعلومات فقط، وليست نصيحة استثمارية.