Quasar Markets Adira grátis

Servidor MCP

Ligue o Claude Desktop, o Cursor ou o seu próprio agente aos dados da Quasar Markets.

Visão geral

O servidor MCP da Quasar Markets disponibiliza as nossas ferramentas de análise financeira a assistentes de IA e aos seus próprios agentes através do Model Context Protocol. Aponte um cliente para o endpoint abaixo, autentique-se com uma chave de API pessoal e as ferramentas passam a surgir junto das restantes capacidades do assistente.

O servidor fala JSON-RPC 2.0 sobre Streamable HTTP. Os pedidos são apenas POST; as respostas chegam como text/event-stream, com o JSON na linha data.

Endpoint

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

Cada pedido leva um token bearer: uma chave de API MCP pessoal começada por QM_MCP_, ou o seu token de utilizador Quasar. As chaves pertencem ao ambiente que as emitiu — uma chave criada num ambiente é recusada noutro.

Início rápido

Crie uma chave na aplicação Quasar em Perfil → MCP e copie-a. A chave é mostrada por inteiro e pode ser renovada ou eliminada a qualquer momento.

Pergunte ao servidor o que sabe fazer. Isto devolve todas as ferramentas com o respetivo esquema de entrada:

Listar as ferramentas

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

Depois chame uma. A maioria das ferramentas espera os argumentos dentro de um objeto payload — o exemplo de cada ferramenta mostra a forma exata.

Chamar uma ferramenta

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

Ligar um cliente

O Claude Desktop lê a lista de servidores em claude_desktop_config.json. Adicione a entrada abaixo e reinicie a aplicação.

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

Em Python, o cliente FastMCP liga-se com a chave 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())

Referência das ferramentas

12 ferramentas, lidas em direto do servidor. Versão do catálogo 1.0.0.

Source Catalog

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

quasar_list_data_sources

Listar fontes de dados

Lista as fontes de dados ativas da Quasar disponíveis para o usuário.

CampoTipoDescrição
flatbooleanReturn every active registry entry with its parent ID. Registry membership does not grant raw-data access.

obrigatório

Exemplo de pedido

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_list_data_sources",
    "arguments": {}
  }
}
Exemplo de resposta
{
  "detail": null,
  "data": [
    {
      "id": 1,
      "name": "Nasdaq",
      "description": "Dados de mercado em tempo real e fundamentais."
    },
    {
      "id": 2,
      "name": "Documentos da SEC",
      "description": "Documentos 10-K, 10-Q e 8-K."
    },
    {
      "id": 3,
      "name": "Dados econômicos do FRED",
      "description": "Indicadores macroeconômicos."
    }
  ]
}

Nasdaq Data Link

Dados financeiros fundamentais, demonstrações, metadados e consultas SQL somente leitura.

quasar_nasdaq_get_stock_fundamentals

Obter fundamentos da ação

Obtém a demonstração de resultados, o balanço patrimonial, o fluxo de caixa e os índices financeiros de um ticker.

CampoTipoDescrição
symbol*stringSímbolo do ticker
limitintegerRegistros por demonstração (1 a 25)

obrigatório

Exemplo de pedido

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_nasdaq_get_stock_fundamentals",
    "arguments": {
      "payload": {
        "symbol": "AAPL",
        "limit": 3
      }
    }
  }
}
Exemplo de resposta
{
  "detail": null,
  "data": {
    "symbol": "AAPL",
    "results": {
      "income_statement": [
        {
          "ticker": "AAPL",
          "revenue": 85777000000
        }
      ]
    }
  }
}

quasar_nasdaq_query_sql

Consulta SQL Nasdaq

Executa SQL restrito somente leitura (SELECT/WITH) nas tabelas permitidas, com limite automático de 100.

CampoTipoDescrição
sql*stringInstrução SQL somente leitura

obrigatório

Exemplo de pedido

{
  "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"
      }
    }
  }
}
Exemplo de resposta
{
  "detail": null,
  "data": [
    {
      "ticker": "AAPL",
      "calendardate": "2024-06-30",
      "revenue": 85777000000
    }
  ]
}

quasar_nasdaq_get_table_metadata

Obter metadados da tabela

Obtém as descrições e os tipos das colunas de uma tabela Nasdaq permitida.

CampoTipoDescrição
table_name*stringNome de tabela permitido (ex.: ndaq_is)

obrigatório

Exemplo de pedido

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_nasdaq_get_table_metadata",
    "arguments": {
      "payload": {
        "table_name": "ndaq_is"
      }
    }
  }
}
Exemplo de resposta
{
  "detail": null,
  "data": {
    "table": "NDAQ_IS",
    "columns": [
      {
        "name": "revenue",
        "type": "numeric"
      }
    ]
  }
}

quasar_nasdaq_search_data_providers

Pesquisar provedores de dados

Pesquisa provedores e catálogos de conjuntos de dados do Nasdaq Data Link.

CampoTipoDescrição
query*stringPalavra-chave de pesquisa

obrigatório

Exemplo de pedido

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_nasdaq_search_data_providers",
    "arguments": {
      "payload": {
        "query": "crypto"
      }
    }
  }
}
Exemplo de resposta
{
  "detail": null,
  "data": [
    {
      "provider_code": "NDAQ_CRYPTO",
      "name": "Índices de criptomoedas"
    }
  ]
}

quasar_nasdaq_discover_available_data

Descobrir dados disponíveis

Descobre todas as tabelas permitidas do Nasdaq Data Link.

Esta ferramenta não recebe argumentos.

Exemplo de pedido

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quasar_nasdaq_discover_available_data",
    "arguments": {}
  }
}
Exemplo de resposta
{
  "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.

CampoTipoDescrição
payload*objectA catalog operation with bounded scalar parameters, never a raw query.

obrigatório

Exemplo de pedido

{
  "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 ferramenta não recebe argumentos.

Exemplo de pedido

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

CampoTipoDescrição
payload*objectExplicit catalog selection; no natural-language or arbitrary URL execution.

obrigatório

Exemplo de pedido

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

CampoTipoDescrição
payload*object

obrigatório

Exemplo de pedido

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

CampoTipoDescrição
payload*object

obrigatório

Exemplo de pedido

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

CampoTipoDescrição
payload*object

obrigatório

Exemplo de pedido

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

Erros

401A chave falta, expirou ou pertence a outro ambiente. Crie ou renove uma chave em Perfil → MCP.
403Um administrador desativou o acesso MCP nesta conta. Contacte o suporte.
405O endpoint aceita apenas POST. Um pedido GET é recusado.
200 com isErrorO pedido era válido mas a ferramenta falhou. O motivo está no conteúdo da resposta; os erros de validação indicam o campo em causa.