الاتصال عبر MCP

استخدم مفتاح Narwhal نفسه ومخططات API العامة نفسها من عميل MCP.

يوفر Narwhal نقطة نهاية MCP واحدة عديمة الحالة عبر HTTP وقابلة للبث. وتستخدم واجهات REST وMCP واجهات البيانات الست نفسها ومخططات الاستجابة والمصادقة والحصة نفسها.

اتصال

أضف عنوان الخادم البعيد وترويسة Bearer إلى عميل MCP يدعم Streamable HTTP المصادق عليه.

خريطة الحقول المحايدة للعميل

{
  "url": "https://api.narwhalapi.com/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_NARWHAL_API_KEY"
  }
}

هذه خريطة حقول، وليست ملفاً جاهزاً للنسخ واللصق. استبدل YOUR_NARWHAL_API_KEY من خلال إعداد السر الآمن في عميلك. لا يوسّع JSON متغيرات الصدفة بنفسه، وتستخدم عملاء MCP صياغات مختلفة لمتغيرات البيئة.

لا تلصق مفتاحًا حقيقيًا في ملف إعدادات مشترك.

الأدوات المتاحة

tools/list يعيد 33 أداة للقراءة فقط: 18 عملية للبيانات الاقتصادية وثلاثًا لكل من أسعار الصرف والأسهم وإيداعات SEC وPalmoil والتقاويم.

economics_get_cpieconomics_get_inflationeconomics_get_unemploymenteconomics_get_labour_force_participationeconomics_get_gdpeconomics_get_gdp_growtheconomics_get_tradeeconomics_get_trade_exportseconomics_get_trade_importseconomics_get_cpi_historyeconomics_get_inflation_historyeconomics_get_unemployment_historyeconomics_get_labour_force_participation_historyeconomics_get_gdp_historyeconomics_get_gdp_growth_historyeconomics_get_trade_historyeconomics_get_trade_exports_historyeconomics_get_trade_imports_historyfx_get_ratesfx_get_rate_historyfx_convert_currencyequities_list_instrumentsequities_get_instrumentequities_get_barscompanies_searchcompanies_getcompanies_list_filingscommodities_discover_physical_seriescommodities_get_oil_palm_ffb_pricecommodities_get_oil_palm_ffb_price_observationscalendars_list_holidayscalendars_get_holidays_on_datecalendars_get_next_holiday

المعلمات والنتائج

تقبل أدوات الإصدار الأحدث country واختيارية periodتقبل أدوات السجل country، اختياري start و end، بالإضافة إلى limit و cursor لترقيم الصفحات.

وسيطات الأداة

{
  "country": "USA",
  "period": "2026-07"
}

بالنسبة لأداتي التجارة الاتجاهيتين، يستخدم MCP "product": { "classification": "HS2022", "code": "27" }تمثل REST المرشح نفسه كـ classification و product الاستعلام المعلمات.

الأداة	الفترة	وسيطات أخرى
`economics_get_cpi`	`YYYY-MM`	لا شيء
`economics_get_inflation`	`YYYY-MM`	لا شيء
`economics_get_unemployment`	`YYYY, YYYY-MM, or YYYY-QN`	لا شيء
`economics_get_labour_force_participation`	`YYYY, YYYY-MM, or YYYY-QN`	لا شيء
`economics_get_gdp`	`YYYY-QN`	لا شيء
`economics_get_gdp_growth`	`YYYY-QN`	لا شيء
`economics_get_trade`	`YYYY or YYYY-MM`	لا شيء
`economics_get_trade_exports`	`YYYY or YYYY-MM`	`partner` ومتداخلة `product` مقبولة، لكن الإجماليات المصفّاة لم تُنشر بعد.
`economics_get_trade_imports`	`YYYY or YYYY-MM`	`partner` ومتداخلة `product` مقبولة، لكن الإجماليات المصفّاة لم تُنشر بعد.
`economics_get_cpi_history`	`YYYY-MM`	`start`, `end`, `limit`، و `cursor`
`economics_get_inflation_history`	`YYYY-MM`	`start`, `end`, `limit`، و `cursor`
`economics_get_unemployment_history`	`YYYY, YYYY-MM, or YYYY-QN`	`start`, `end`, `limit`، و `cursor`
`economics_get_labour_force_participation_history`	`YYYY, YYYY-MM, or YYYY-QN`	`start`, `end`, `limit`، و `cursor`
`economics_get_gdp_history`	`YYYY-QN`	`start`, `end`, `limit`، و `cursor`
`economics_get_gdp_growth_history`	`YYYY-QN`	`start`, `end`, `limit`، و `cursor`
`economics_get_trade_history`	`YYYY-MM`	`start`, `end`, `limit`، و `cursor`
`economics_get_trade_exports_history`	`YYYY-MM`	`start`, `end`, `limit`، و `cursor`
`economics_get_trade_imports_history`	`YYYY-MM`	`start`, `end`, `limit`، و `cursor`

تعيد استدعاءات الأدوات الناجحة نتائج مطابقة للمخطط structuredContent بالإضافة إلى JSON نفسه المتسلسل كنص لتوافق العملاء. تستخدم مشكلات MCP مفردات الحالة والرموز العامة نفسها المستخدمة في REST.

سلوك الحصة

لا تستهلك التهيئة واكتشاف الأدوات حصة البيانات. وكل استدعاء ناجح tools/call يستهلك طلباً واحداً بالضبط، مثل استدعاء REST ناجح واحد.

أول استدعاء للأداة

{
  "method": "tools/call",
  "params": {
    "name": "fx_get_rates",
    "arguments": { "base": "USD", "currencies": ["EUR", "JPY"] }
  }
}

يتضمن الإصدار التجريبي المجاني 3,000 الطلبات الناجحة لكل شهر وفق UTC، بالإضافة إلى 30 طلبًا في الدقيقة مع دفعة قدرها 5تُعاد حالة الحصة في X-RateLimit-Limit, X-RateLimit-Remaining، و X-RateLimit-Reset؛ تُعاد حالة النافذة القصيرة في X-RateLimit-Short-Limit, X-RateLimit-Short-Remaining، و X-RateLimit-Short-Resetيعيد تقييد النافذة القصيرة 429 rate_limit_exceeded؛ يعيد استنفاد الحصة الشهرية 429 quota_exhausted.

استكشاف الأخطاء وإصلاحها

العَرَض	تحقّق
`401 invalid_api_key`	أكد ترويسة Bearer الدقيقة وأن المفتاح ما زال نشطًا.
يتبع الاتصال إعادة توجيه	استخدم بالضبط `https://api.narwhalapi.com/mcp` من دون شرطة مائلة في النهاية.
الأداة مفقودة	لا تتوفر إلا الأدوات العامة المذكورة أعلاه.
تعيد الأداة مشكلة	اقرأ حالتها ورمزها وتفاصيلها ومعرّف الطلب المنظم. راجع الأخطاء والحصة.