Query mode and Execute mode

Query mode

Use Query mode when your application starts with a research question and benefits from Context selecting the correct Meridian method, validating the evidence, and assembling a response. Pin Meridian with its tool ID when the workflow must use this provider:

const result = await client.query.run({
  query: "Use Meridian to compare BTC funding and dollar open interest across venues.",
  tools: [MERIDIAN_TOOL_ID],
  responseShape: "evidence_only",
  includeDataUrl: true,
});

Use answer_with_evidence when Context should also write the answer. Use evidence_only when your own application or agent will perform the analysis.

Execute mode

Use Execute mode when you already know the exact Meridian method and arguments and want the structured result directly.

const meridian = await client.discovery.get(MERIDIAN_TOOL_ID);
const futures = meridian.mcpTools?.find((method) => method.name === "futures");

if (!futures?.executeEligible || !futures.executePriceUsd) {
  throw new Error("Meridian futures is not currently Execute-eligible");
}

Pin the published Meridian tool ID for production integrations. Ranked search remains useful for agents discovering unknown providers, but it should not be a dependency after an application has selected Meridian.

Decision table

Requirement	Use
Natural-language market question	Query
Context should select `futures` or `spot`	Query
Your agent writes the final analysis	Query with `evidence_only`
Exact tool method and exact arguments	Execute, when eligible
Long or broad historical query	Query with a data URL or asynchronous job
Lowest orchestration ambiguity	Execute, when eligible

Response profiles

Use the lean profile for ordinary application calls:

{
  "include": {
    "coverage": false,
    "provenance": false,
    "column_metadata": false
  }
}

Enable coverage when classifying nulls. Enable column metadata when types and units are needed. Request provenance only for a narrow lineage audit rather than attaching it to every row query.

Overview

Getting Started

Context Integration

Tool Reference

Data Catalog

Custom Bars

Operations

Query mode and Execute mode

Query mode

Execute mode

Decision table

Response profiles

​Query mode

​Execute mode

​Decision table

​Response profiles

Query mode

Execute mode

Decision table

Response profiles