Discover Omni for free, then approve each paid MCP tool call.

• Open Agent Quickstart Compare HTTP, MCP, and SDK paths.
• View MCP source example Run the committed client.

The application approves payment; the model does not receive the buyer key.

import { OmniMcpClient } from "@omni-terminal/sdk";

const privateKey = process.env.EVM_PRIVATE_KEY;
if (!privateKey || !/^0x[0-9a-fA-F]{64}$/.test(privateKey)) {
  throw new Error("EVM_PRIVATE_KEY must be a 32-byte hex key");
}
const buyerKey = /** @type {`0x${string}`} */ (privateKey);

const client = await new OmniMcpClient({
  privateKey: buyerKey,
  maxPaymentUsd: 0.010,
  approvePayment: ({ toolName, paymentRequired }) => {
    console.log({ toolName, accepts: paymentRequired.accepts });
    return toolName === "get_market_risk_context";
  }
}).connect();

try {
  console.log((await client.catalogData()).data); // free
  const result = await client.marketRiskData({
    symbol: "BTC",
    scope: "current",
    limit: 5
  });
  console.log({ schema: result.data.schema, payment: result.payment });
} finally {
  await client.close();
}

• The free catalog must never trigger payment; the SDK treats that as a contract error.
• The approvePayment callback can inspect the selected tool and current requirements.
• The independent payment-client cap still applies when the callback returns true.

The map below is the typed SDK set. The server can list more read-only tools.

import { OmniMcpClient } from "@omni-terminal/sdk";

const client = await new OmniMcpClient().connect();
try {
  const listed = await client.listTools();
  for (const tool of listed.tools) console.log(tool.name);
} finally {
  await client.close();
}

• This call is free. It does not place orders or move collateral.
• SDK 0.8.1 methods cover the six names in the tool map. A name with no method is still called through your MCP host.
• Approve the amount in the payment challenge for that call. A price in the tool map does not apply to the other tools.

Choose the smallest tool that completes the task.

• get_market_catalog: free discovery.
• get_market_moving_events: 0.010 USDC for bounded equities, crypto, macro, or forex catalysts.
• get_premarket_roundup: 0.100 USDC for the published roundup, with optional date and bounded limit. Confirm current terms in the live payment challenge before approving.
• get_market_risk_context: 0.010 USDC for joined liquidation levels, stress, funding, and news.
• resolve_market_entities: 0.001 USDC for 1–20 current aliases.
• get_market_carry: 0.003 USDC for current 1h funding with mechanical 8h, 1d, and APR context.

Use Bazaar when the agent already discovers x402 HTTP resources through Coinbase CDP.

• Connect https://api.cdp.coinbase.com/platform/v2/x402/discovery/mcp.
• Call search_resources for Omni and inspect the returned HTTP resource descriptors.
• Pass the selected generated tool name and arguments to proxy_tool_call.
• The proxy returns the same bounded x402 payment requirement and product; the currently indexed Bazaar resources remain HTTP resources.

Typed Omni MCP helpers cover six tools: one free catalog plus five paid products. Use listTools() to verify the deployed inventory and tool schemas. Coinbase Bazaar MCP exposes the currently indexed HTTP products through its own search/proxy interface.

• MCP example

  https://github.com/InTheta/omni-universe-sdks/blob/main/packages/typescript/examples/mcp-all-tools.ts

  Guarded free and paid native tool lifecycle.

• MCP client

  https://github.com/InTheta/omni-universe-sdks/blob/main/packages/typescript/src/mcp.ts

  Transport, approvals, validation, and payment result handling.

• x402 API reference

  omni-terminal/docs/X402_API_REFERENCE.md

  Native MCP and Bazaar MCP contracts.