Server MCP

Colleghi Claude Desktop, Cursor o il suo agente ai dati di Quasar Markets.

Panoramica

Il server MCP di Quasar Markets espone i nostri strumenti di ricerca finanziaria agli assistenti IA e ai suoi agenti tramite il Model Context Protocol. Indirizzi un client all’endpoint qui sotto, si autentichi con una chiave API personale e gli strumenti compariranno accanto alle altre capacità del suo assistente.

Il server parla JSON-RPC 2.0 su Streamable HTTP. Le richieste sono solo POST; le risposte arrivano come text/event-stream, con il JSON sulla riga data.

Endpoint

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

Ogni richiesta porta un token bearer: una chiave API MCP personale che inizia con QM_MCP_, oppure il suo token utente Quasar. Le chiavi appartengono all’ambiente che le ha emesse — una chiave creata in un ambiente viene rifiutata in un altro.

Avvio rapido

Crei una chiave nell’app Quasar in Profilo → MCP e la copi. La chiave è mostrata per intero e può essere rigenerata o eliminata in qualsiasi momento.

Chieda al server cosa sa fare. Vengono restituiti tutti gli strumenti con il relativo schema di input:

Elenca gli strumenti

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": {}
  }'

Poi ne richiami uno. La maggior parte degli strumenti vuole gli argomenti dentro un oggetto payload — l’esempio di ogni strumento mostra la forma esatta.

Richiama uno strumento

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": {}
    }
  }'

Collegare un client

Claude Desktop legge l’elenco dei server da claude_desktop_config.json. Aggiunga la voce qui sotto e riavvii l’app.

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"
      ]
    }
  }
}

Da Python, il client FastMCP si collega con la chiave come argomento 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())

Riferimento strumenti

12 strumenti, letti dal vivo dal server. Versione del catalogo 1.0.0.

Source Catalog

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

quasar_list_data_sources

Elenca le fonti dati

Elenca le fonti dati Quasar attive disponibili per l'utente.

Campo	Tipo	Descrizione
flat	boolean	Return every active registry entry with its parent ID. Registry membership does not grant raw-data access.

obbligatorio

Esempio di richiesta

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

Esempio di risposta

{
  "detail": null,
  "data": [
    {
      "id": 1,
      "name": "Nasdaq",
      "description": "Dati di mercato in tempo reale e fondamentali."
    },
    {
      "id": 2,
      "name": "Documenti depositati presso la SEC",
      "description": "Documenti 10-K, 10-Q e 8-K."
    },
    {
      "id": 3,
      "name": "Dati economici FRED",
      "description": "Indicatori macroeconomici."
    }
  ]
}

Nasdaq Data Link

Dati finanziari fondamentali, bilanci, metadati e query SQL di sola lettura.

quasar_nasdaq_get_stock_fundamentals

Ottieni i fondamentali di un titolo

Recupera conto economico, stato patrimoniale, flussi di cassa e indici finanziari di un ticker.

Campo	Tipo	Descrizione
symbol*	string	Simbolo del ticker
limit	integer	Record per prospetto (1-25)

obbligatorio

Esempio di richiesta

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_nasdaq_get_stock_fundamentals",
    "arguments": {
      "payload": {
        "symbol": "AAPL",
        "limit": 3
      }
    }
  }
}

Esempio di risposta

{
  "detail": null,
  "data": {
    "symbol": "AAPL",
    "results": {
      "income_statement": [
        {
          "ticker": "AAPL",
          "revenue": 85777000000
        }
      ]
    }
  }
}

quasar_nasdaq_query_sql

Query SQL Nasdaq

Esegue SQL di sola lettura con restrizioni (SELECT/WITH) sulle tabelle consentite, con limite automatico di 100.

Campo	Tipo	Descrizione
sql*	string	Istruzione SQL di sola lettura

obbligatorio

Esempio di richiesta

{
  "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"
      }
    }
  }
}

Esempio di risposta

{
  "detail": null,
  "data": [
    {
      "ticker": "AAPL",
      "calendardate": "2024-06-30",
      "revenue": 85777000000
    }
  ]
}

quasar_nasdaq_get_table_metadata

Ottieni i metadati della tabella

Recupera descrizioni e tipi delle colonne di una tabella Nasdaq consentita.

Campo	Tipo	Descrizione
table_name*	string	Nome di tabella consentito (es. ndaq_is)

obbligatorio

Esempio di richiesta

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_nasdaq_get_table_metadata",
    "arguments": {
      "payload": {
        "table_name": "ndaq_is"
      }
    }
  }
}

Esempio di risposta

{
  "detail": null,
  "data": {
    "table": "NDAQ_IS",
    "columns": [
      {
        "name": "revenue",
        "type": "numeric"
      }
    ]
  }
}

quasar_nasdaq_search_data_providers

Cerca fornitori di dati

Cerca tra i fornitori e i cataloghi di dataset di Nasdaq Data Link.

Campo	Tipo	Descrizione
query*	string	Parola chiave di ricerca

obbligatorio

Esempio di richiesta

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

Esempio di risposta

{
  "detail": null,
  "data": [
    {
      "provider_code": "NDAQ_CRYPTO",
      "name": "Indici crypto"
    }
  ]
}

quasar_nasdaq_discover_available_data

Scopri i dati disponibili

Individua tutte le tabelle Nasdaq Data Link consentite.

Questo strumento non accetta argomenti.

Esempio di richiesta

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

Esempio di risposta

{
  "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.

Campo	Tipo	Descrizione
payload*	object	A catalog operation with bounded scalar parameters, never a raw query.

obbligatorio

Esempio di richiesta

{
  "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.

Questo strumento non accetta argomenti.

Esempio di richiesta

{
  "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.

Campo	Tipo	Descrizione
payload*	object	Explicit catalog selection; no natural-language or arbitrary URL execution.

obbligatorio

Esempio di richiesta

{
  "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.

Campo	Tipo	Descrizione
payload*	object

obbligatorio

Esempio di richiesta

{
  "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.

Campo	Tipo	Descrizione
payload*	object

obbligatorio

Esempio di richiesta

{
  "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.

Campo	Tipo	Descrizione
payload*	object

obbligatorio

Esempio di richiesta

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

Errori

401	La chiave manca, è scaduta o appartiene a un altro ambiente. Crei o rigeneri una chiave in Profilo → MCP.
403	Un amministratore ha disattivato l’accesso MCP per questo account. Contatti l’assistenza.
405	L’endpoint accetta solo POST. Una richiesta GET viene rifiutata.
200 con isError	La richiesta era valida ma lo strumento è fallito. Il motivo si trova nel contenuto della risposta; gli errori di validazione indicano il campo interessato.