> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quantoraresearch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP server

> Connect an agent to Quantora over the hosted MCP endpoint.

Quantora runs a hosted MCP server, so an agent in Claude, Claude Code, Cursor or any other MCP client can query the same data the REST API serves. There is nothing to install and no Node process to keep running: point the client at the endpoint and authenticate with your API key.

<Note>
  Every tool is read-only. The server reads data, it cannot change your account, your keys or your billing.
</Note>

## Endpoint

```text theme={"dark"}
https://mcp.quantoraresearch.com
```

Authentication uses the same key as the REST API, sent either as an `x-api-key` header or as `Authorization: Bearer YOUR_API_KEY`. Create and manage keys in your [account console](https://app.financialdatapi.com).

<Warning>
  Authentication is a static API key, there is no OAuth flow yet. Your key ends up in a client config file on disk, so treat it like any other secret and rotate it from the console if a machine is shared or lost.
</Warning>

## Connect your client

<Steps>
  <Step title="Claude Code">
    Run this in your terminal, with your key in place of `YOUR_API_KEY`:

    ```bash theme={"dark"}
    claude mcp add --transport http quantora https://mcp.quantoraresearch.com \
      --header "x-api-key: YOUR_API_KEY"
    ```
  </Step>

  <Step title="Claude Desktop or Cursor">
    Add the server to your MCP config (`claude_desktop_config.json`, or Cursor's `mcp.json`), then restart the app:

    ```json theme={"dark"}
    {
      "mcpServers": {
        "quantora": {
          "url": "https://mcp.quantoraresearch.com",
          "headers": { "x-api-key": "YOUR_API_KEY" }
        }
      }
    }
    ```
  </Step>

  <Step title="Clients without HTTP transport">
    Older clients that only speak stdio can bridge through `mcp-remote`:

    ```bash theme={"dark"}
    npx -y mcp-remote https://mcp.quantoraresearch.com/mcp \
      --header x-api-key:YOUR_API_KEY
    ```
  </Step>
</Steps>

## Tools

The server exposes 33 tools. They return the same objects, units and trust metadata as the REST endpoints they sit on, so anything you read in [Core concepts](/concepts/observations) applies here too.

### Discovery and resolution

| Tool | What it does |
| - | - |
| `search_catalog` | Find any indicator, series or field by name, slug, family, alias or provider code. |
| `resolve` | Resolve a country, company or FX symbol to the canonical id the other tools expect. |
| `list_countries` | List covered countries with their central bank, peers and trading partners. |
| `list_sources` | List sources with their rights fields, so you can tell redistributable data from internal only. |
| `coverage_map` | What exists across countries and indicators, and how deep the history goes. |

### Macro observations

| Tool | What it does |
| - | - |
| `get_observations` | The low-level time series for any indicator. |
| `get_latest` | Many indicators for one entity, the country panel in a single call. |
| `get_indicator_across_entities` | One indicator across many entities, for ranking and comparison. |
| `get_latest_per_entity` | Deprecated alias of `get_indicator_across_entities`. Prefer that name. |
| `cross_country` | Macro differentials for a scope against its peer basket. |
| `rates_analytics` | Sovereign spreads against peers, and curve slopes. |

### Screeners

| Tool | What it does |
| - | - |
| `screen_macro` | Screen countries by macro indicator values. |
| `screener_fields` | The screenable macro fields, operators and query syntax. |
| `screen_equities` | Screen the scored company universe by fundamentals in one call. |
| `equity_screener_fields` | The screenable equity fields, including valuation multiples and analytics. |

### Companies

| Tool | What it does |
| - | - |
| `list_companies` | The scored company universe with ticker, sector and industry. |
| `get_company` | Company identity plus pre-computed margin, liquidity, leverage and return snapshots. |
| `get_company_financials` | SEC income statement, balance sheet and cash flow, newest period first. |
| `get_earnings` | Point-in-time earnings actuals with explicit knowledge-time semantics. |
| `company_valuation` | Every trailing valuation multiple for a company in one call. |
| `company_snapshot` | Valuation, margins, liquidity, leverage and returns together. Best for comparisons. |
| `insider_trades` | SEC Form 3, 4 and 5 insider transactions with name, role and transaction code. |
| `get_filing_items` | The text of a single SEC filing section, so you read only the item you need. |
| `institutional_holdings` | SEC Form 13F positions, one row per filer, issuer and quarter. |
| `activist_events` | Schedule 13D filings across companies, the activist watch feed. |

### Markets, FX and positioning

| Tool | What it does |
| - | - |
| `fx_rates` | FX reference rates from the ECB and central banks. |
| `energy_series` | EIA energy series. |
| `cot_market` | Find a CFTC Commitments of Traders market and get its canonical slug. |
| `cot_positioning` | A market's CFTC positioning, with percentile rankings. |

### Events and provenance

| Tool | What it does |
| - | - |
| `economic_calendar` | Data releases and central bank meetings. |
| `trump_posts` | Truth Social posts with timestamp, deep link and engagement metadata. |
| `observation_provenance` | Source, raw payload metadata and lineage for one observation. |
| `source_health` | Per-source connector freshness. |

## Rights and freshness still apply

The MCP tools are a different transport, not a different dataset. Two fields decide whether a row is safe for what you are building, and both come back through MCP exactly as they do over HTTP:

<CardGroup cols={2}>
  <Card title="Sources and rights" icon="scale-balanced" href="/concepts/sources-and-rights">
    Which series may be redistributed, and which are licensed for internal use only.
  </Card>

  <Card title="Trust metadata" icon="shield-check" href="/concepts/trust-metadata">
    Freshness status and scoring eligibility, so an agent can tell a stale row from a current one.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.