Servidor MCP

Conecte Claude Desktop, Cursor o su propio agente a los datos de Quasar Markets.

Descripción general

El servidor MCP de Quasar Markets expone nuestras herramientas de análisis financiero a asistentes de IA y a sus propios agentes mediante el Model Context Protocol. Apunte un cliente al endpoint indicado, autentíquese con una clave de API personal y las herramientas aparecerán junto al resto de capacidades de su asistente.

El servidor habla JSON-RPC 2.0 sobre Streamable HTTP. Las peticiones son solo POST; las respuestas llegan como text/event-stream, con el JSON en la línea data.

Endpoint

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

Cada petición lleva un token bearer: una clave de API de MCP personal que empieza por QM_MCP_, o su token de usuario de Quasar. Las claves pertenecen al entorno que las emitió — una clave creada en un entorno se rechaza en otro.

Inicio rápido

Cree una clave en la aplicación de Quasar en Perfil → MCP y cópiela. La clave se muestra completa y puede rotarse o eliminarse en cualquier momento.

Pregúntele al servidor qué sabe hacer. Esto devuelve cada herramienta con su esquema de entrada:

Listar las herramientas

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

Después llame a una. La mayoría de las herramientas esperan sus argumentos dentro de un objeto payload — el ejemplo de cada herramienta muestra la forma exacta.

Llamar a una herramienta

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

Conectar un cliente

Claude Desktop lee su lista de servidores de claude_desktop_config.json. Añada la entrada siguiente y reinicie la aplicación.

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

Desde Python, el cliente FastMCP se conecta con la clave como argumento 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())

Referencia de herramientas

12 herramientas, leídas en vivo del servidor. Versión del catálogo 1.0.0.

Source Catalog

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

quasar_list_data_sources

Listar fuentes de datos

Muestra las fuentes de datos activas de Quasar disponibles para el usuario.

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

obligatorio

Ejemplo de petición

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

Ejemplo de respuesta

{
  "detail": null,
  "data": [
    {
      "id": 1,
      "name": "Nasdaq",
      "description": "Datos de mercado en tiempo real y fundamentales."
    },
    {
      "id": 2,
      "name": "Presentaciones ante la SEC",
      "description": "Presentaciones 10-K, 10-Q y 8-K."
    },
    {
      "id": 3,
      "name": "Datos económicos de FRED",
      "description": "Indicadores macroeconómicos."
    }
  ]
}

Nasdaq Data Link

Datos financieros fundamentales, estados financieros, metadatos y consultas SQL de solo lectura.

quasar_nasdaq_get_stock_fundamentals

Obtener fundamentales de la acción

Obtiene el estado de resultados, el balance general, el flujo de caja y los ratios financieros de un ticker.

Campo	Tipo	Descripción
symbol*	string	Símbolo del ticker
limit	integer	Registros por estado financiero (1 a 25)

obligatorio

Ejemplo de petición

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

Ejemplo de respuesta

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

quasar_nasdaq_query_sql

Consulta SQL de Nasdaq

Ejecuta SQL restringido de solo lectura (SELECT/WITH) sobre tablas permitidas, con un límite automático de 100.

Campo	Tipo	Descripción
sql*	string	Instrucción SQL de solo lectura

obligatorio

Ejemplo de petición

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

Ejemplo de respuesta

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

quasar_nasdaq_get_table_metadata

Obtener metadatos de la tabla

Obtiene las descripciones y los tipos de columnas de una tabla de Nasdaq permitida.

Campo	Tipo	Descripción
table_name*	string	Nombre de tabla permitido (p. ej., ndaq_is)

obligatorio

Ejemplo de petición

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

Ejemplo de respuesta

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

quasar_nasdaq_search_data_providers

Buscar proveedores de datos

Busca proveedores y catálogos de conjuntos de datos de Nasdaq Data Link.

Campo	Tipo	Descripción
query*	string	Palabra clave de búsqueda

obligatorio

Ejemplo de petición

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

Ejemplo de respuesta

{
  "detail": null,
  "data": [
    {
      "provider_code": "NDAQ_CRYPTO",
      "name": "Índices de criptomonedas"
    }
  ]
}

quasar_nasdaq_discover_available_data

Descubrir datos disponibles

Descubre todas las tablas permitidas de Nasdaq Data Link.

Esta herramienta no acepta argumentos.

Ejemplo de petición

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

Ejemplo de respuesta

{
  "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	Descripción
payload*	object	A catalog operation with bounded scalar parameters, never a raw query.

obligatorio

Ejemplo de petición

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

Esta herramienta no acepta argumentos.

Ejemplo de petición

{
  "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	Descripción
payload*	object	Explicit catalog selection; no natural-language or arbitrary URL execution.

obligatorio

Ejemplo de petición

{
  "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	Descripción
payload*	object

obligatorio

Ejemplo de petición

{
  "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	Descripción
payload*	object

obligatorio

Ejemplo de petición

{
  "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	Descripción
payload*	object

obligatorio

Ejemplo de petición

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

Errores

401	La clave falta, ha caducado o pertenece a otro entorno. Cree o rote una clave en Perfil → MCP.
403	Un administrador ha desactivado el acceso MCP para esta cuenta. Póngase en contacto con el soporte.
405	El endpoint solo acepta POST. Una petición GET se rechaza.
200 con isError	La petición era válida pero la herramienta falló. El motivo está en el contenido del resultado; los errores de validación nombran el campo afectado.