Quasar Markets انضم مجانًا

خادم MCP

اربط Claude Desktop أو Cursor أو وكيلك الخاص ببيانات Quasar Markets.

نظرة عامة

يتيح خادم MCP من Quasar Markets أدوات البحث المالي لمساعدي الذكاء الاصطناعي ولوكلائك عبر Model Context Protocol. وجّه عميلاً إلى العنوان أدناه، وصادق بمفتاح واجهة شخصي، وستظهر الأدوات إلى جانب بقية قدرات مساعدك.

يستخدم الخادم JSON-RPC 2.0 عبر Streamable HTTP. الطلبات بطريقة POST فقط؛ وتعود الاستجابات بصيغة text/event-stream مع بيانات JSON في سطر data.

العنوان

https://ai-api.quasarmarkets.com/mcp

يحمل كل طلب رمز bearer: إما مفتاح MCP شخصي يبدأ بـ QM_MCP_ أو رمز مستخدم Quasar الخاص بك. ترتبط المفاتيح بالبيئة التي أصدرتها — ويُرفض المفتاح في أي بيئة أخرى.

بداية سريعة

أنشئ مفتاحاً في تطبيق Quasar ضمن الملف الشخصي ← MCP ثم انسخه. يُعرض المفتاح كاملاً ويمكن تجديده أو حذفه في أي وقت.

اسأل الخادم عما يمكنه فعله. يعيد ذلك كل أداة مع مخطط مدخلاتها:

سرد الأدوات

curl 'https://ai-api.quasarmarkets.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Authorization: Bearer QM_MCP_your_key_here' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

ثم استدعِ إحداها. تتوقع معظم الأدوات وسائطها داخل كائن payload — ويوضّح المثال أسفل كل أداة الشكل الدقيق.

استدعاء أداة

curl 'https://ai-api.quasarmarkets.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Authorization: Bearer QM_MCP_your_key_here' \
  --data '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "quasar_list_data_sources",
      "arguments": {}
    }
  }'

ربط عميل

يقرأ Claude Desktop قائمة الخوادم من claude_desktop_config.json. أضف المدخل أدناه ثم أعد تشغيل التطبيق.

Claude Desktop

{
  "mcpServers": {
    "quasar-markets": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ai-api.quasarmarkets.com/mcp",
        "--header",
        "Authorization: Bearer QM_MCP_your_key_here"
      ]
    }
  }
}

من Python، يتصل عميل FastMCP باستخدام المفتاح كوسيط auth.

Python

import asyncio
from fastmcp import Client

async def run():
    async with Client("https://ai-api.quasarmarkets.com/mcp", auth="QM_MCP_your_key_here") as client:
        tools = await client.list_tools()
        print(f"{len(tools)} tools available")

asyncio.run(run())

مرجع الأدوات

12 أداة، تُقرأ مباشرةً من الخادم. إصدار القائمة 1.0.0.

Source Catalog

Public data-source registry metadata; no AI generation or user records.

quasar_list_data_sources

عرض مصادر البيانات

يعرض مصادر بيانات Quasar النشطة المتاحة للمستخدم.

الحقلالنوعالوصف
flatbooleanReturn every active registry entry with its parent ID. Registry membership does not grant raw-data access.

مطلوب

مثال على الطلب

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_list_data_sources",
    "arguments": {}
  }
}
مثال على الاستجابة
{
  "detail": null,
  "data": [
    {
      "id": 1,
      "name": "Nasdaq",
      "description": "بيانات السوق الفورية والأساسية."
    },
    {
      "id": 2,
      "name": "إيداعات SEC",
      "description": "إيداعات 10-K و10-Q و8-K."
    },
    {
      "id": 3,
      "name": "بيانات FRED الاقتصادية",
      "description": "المؤشرات الاقتصادية الكلية."
    }
  ]
}

Nasdaq Data Link

البيانات المالية الأساسية والقوائم المالية والبيانات الوصفية واستعلامات SQL للقراءة فقط.

quasar_nasdaq_get_stock_fundamentals

جلب البيانات الأساسية للسهم

يجلب قائمة الدخل والميزانية العمومية والتدفقات النقدية والنسب المالية لرمز السهم.

الحقلالنوعالوصف
symbol*stringرمز السهم
limitintegerعدد السجلات لكل قائمة مالية (من 1 إلى 25)

مطلوب

مثال على الطلب

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_nasdaq_get_stock_fundamentals",
    "arguments": {
      "payload": {
        "symbol": "AAPL",
        "limit": 3
      }
    }
  }
}
مثال على الاستجابة
{
  "detail": null,
  "data": {
    "symbol": "AAPL",
    "results": {
      "income_statement": [
        {
          "ticker": "AAPL",
          "revenue": 85777000000
        }
      ]
    }
  }
}

quasar_nasdaq_query_sql

استعلام SQL من Nasdaq

ينفّذ استعلام SQL مقيّدًا للقراءة فقط (SELECT/WITH) على الجداول المسموح بها، بحد أقصى تلقائي قدره 100 صف.

الحقلالنوعالوصف
sql*stringعبارة SQL للقراءة فقط

مطلوب

مثال على الطلب

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_nasdaq_query_sql",
    "arguments": {
      "payload": {
        "sql": "SELECT ticker, calendardate, revenue FROM ndaq_is WHERE ticker = 'AAPL' LIMIT 5"
      }
    }
  }
}
مثال على الاستجابة
{
  "detail": null,
  "data": [
    {
      "ticker": "AAPL",
      "calendardate": "2024-06-30",
      "revenue": 85777000000
    }
  ]
}

quasar_nasdaq_get_table_metadata

جلب البيانات الوصفية للجدول

يجلب أوصاف الأعمدة وأنواعها لجدول Nasdaq مسموح به.

الحقلالنوعالوصف
table_name*stringاسم جدول مسموح به (مثل ndaq_is)

مطلوب

مثال على الطلب

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_nasdaq_get_table_metadata",
    "arguments": {
      "payload": {
        "table_name": "ndaq_is"
      }
    }
  }
}
مثال على الاستجابة
{
  "detail": null,
  "data": {
    "table": "NDAQ_IS",
    "columns": [
      {
        "name": "revenue",
        "type": "numeric"
      }
    ]
  }
}

quasar_nasdaq_search_data_providers

البحث عن مزوّدي البيانات

يبحث في مزوّدي Nasdaq Data Link وفهارس مجموعات البيانات.

الحقلالنوعالوصف
query*stringكلمة البحث

مطلوب

مثال على الطلب

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_nasdaq_search_data_providers",
    "arguments": {
      "payload": {
        "query": "crypto"
      }
    }
  }
}
مثال على الاستجابة
{
  "detail": null,
  "data": [
    {
      "provider_code": "NDAQ_CRYPTO",
      "name": "مؤشرات العملات المشفرة"
    }
  ]
}

quasar_nasdaq_discover_available_data

استكشاف البيانات المتاحة

يستكشف جميع جداول Nasdaq Data Link المسموح بها.

لا تأخذ هذه الأداة أي وسائط.

مثال على الطلب

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_nasdaq_discover_available_data",
    "arguments": {}
  }
}
مثال على الاستجابة
{
  "detail": null,
  "data": {
    "available_tables": [
      "ndaq_bs",
      "ndaq_cf",
      "ndaq_fd",
      "ndaq_is",
      "ndaq_stat"
    ]
  }
}

Structured Data

Retrieve observations; the client AI writes the answer. No Quasar LLM calls.

quasar_query_source

Query a Data Source

Read an explicit FRED, Edgar or backend source operation using the resource catalog parameters and field limitations.

الحقلالنوعالوصف
payload*objectA catalog operation with bounded scalar parameters, never a raw query.

مطلوب

مثال على الطلب

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_query_source",
    "arguments": {
      "payload": {
        "source": "fred",
        "operation": "observations",
        "parameters": {
          "series_id": "UNRATE"
        },
        "limit": 12
      }
    }
  }
}

quasar_list_data_resources

List Queryable Data Resources

Discover supported resource IDs, series and parameter schemas, with coverage limitations.

لا تأخذ هذه الأداة أي وسائط.

مثال على الطلب

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_list_data_resources",
    "arguments": {}
  }
}

quasar_query_data

Query Structured Data

Fetch a catalog series without Quasar AI generation. Unsupported requests fail without fallback.

الحقلالنوعالوصف
payload*objectExplicit catalog selection; no natural-language or arbitrary URL execution.

مطلوب

مثال على الطلب

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_query_data",
    "arguments": {
      "payload": {
        "resource": "fred",
        "series_id": "fred:unrate",
        "limit": 12
      }
    }
  }
}

quasar_search_sources

Search Sources

Find sources using provider names and subject keywords.

الحقلالنوعالوصف
payload*object

مطلوب

مثال على الطلب

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_search_sources",
    "arguments": {
      "payload": {
        "query": "unemployment"
      }
    }
  }
}

quasar_describe_source

Describe Source

Read exact operation schemas, supported entity lookups and coverage limits.

الحقلالنوعالوصف
payload*object

مطلوب

مثال على الطلب

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_describe_source",
    "arguments": {
      "payload": {
        "source": "edgar"
      }
    }
  }
}

quasar_search_source_entities

Search Source Entities

Resolve names and metrics into candidate identifiers; clarify ambiguity before querying.

الحقلالنوعالوصف
payload*object

مطلوب

مثال على الطلب

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_search_source_entities",
    "arguments": {
      "payload": {
        "source": "edgar",
        "kind": "companies",
        "query": "Apple"
      }
    }
  }
}

الأخطاء

401المفتاح مفقود أو منتهٍ أو يخص بيئة أخرى. أنشئ مفتاحاً أو جدّده ضمن الملف الشخصي ← MCP.
403أوقف أحد المسؤولين وصول MCP لهذا الحساب. يرجى التواصل مع الدعم.
405يقبل العنوان POST فقط، ويُرفض طلب GET.
200 مع isErrorكان الطلب صحيحاً لكن الأداة نفسها فشلت. السبب مذكور في محتوى النتيجة؛ وتشير أخطاء التحقق إلى الحقل المعني.