DEPTH4 MCP for agents

Connect Cursor, Claude Code, or LangChain to DEPTH4's intelligence engine. Paid subscribers issue API keys from My account. Personal agent use only — no resale or redistribution.

Remote MCP

Point Cursor, or any Streamable HTTP client, at https://depth4.com/api/mcp. Send Authorization: Bearer depth4_mcp_…. Keys are read-only personal access tokens. This endpoint does not use OAuth — paste the key into the client.

{
  "mcpServers": {
    "depth4": {
      "url": "https://depth4.com/api/mcp",
      "headers": { "Authorization": "Bearer depth4_mcp_…" }
    }
  }
}

Sign in on an Insider or Pro account.
Open Account → Agent / MCP Access.
Generate a key and copy it. It is shown once. Revoke it there if it leaks.
Add the remote server URL and the Bearer header in the MCP client.
Call depth4_get_signal with XAUUSD, BTC, or oil.

Authentication

Keys use the depth4_mcp_ prefix. Only a SHA-256 hash is stored. For the local stdio server, set DEPTH4_MCP_API_KEY. For HTTP, send Authorization: Bearer depth4_mcp_… or header x-depth4-mcp-key. A missing or revoked key returns HTTP 401.

Local stdio

{
  "mcpServers": {
    "depth4": {
      "command": "node",
      "args": ["/path/to/signal/apps/mcp/dist/index.js"],
      "env": { "DEPTH4_MCP_API_KEY": "depth4_mcp_…" }
    }
  }
}

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "node",
  args: ["signal/apps/mcp/dist/index.js"],
  env: { ...process.env, DEPTH4_MCP_API_KEY: process.env.DEPTH4_MCP_API_KEY },
});
const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(transport);
const result = await client.callTool({ name: "depth4_list_signals", arguments: { limit: 10 } });

Tool reference

Tool	Tier	Params	Returns
depth4_list_signals	Insider+	tradability, actionable_only, symbols, limit	signal_state, as_of, latest_theses
depth4_get_signal	Insider+; Pro adds book alignment	symbol	RISING / FALLING / MIXED, as_of, latest_theses
depth4_get_thesis	Insider+	slug	Full cascade for one slug
depth4_get_feed_updates	Insider+ (fleet); Pro (watchlist/book)	since_iso, scope	Feed items
depth4_get_copilot_context	Insider (macro); Pro (full)	symbol, mode	Tradability context
depth4_get_daily_digest	Insider+ (fleet); Pro (scoped + entry_timing)	scope, industry	Daily digest JSON
depth4_get_account_scope	Pro only	—	Book, stars, industry tags

Signal state

signal_state is the SIGNALS page badge: RISING, FALLING, or MIXED. A single story stays MIXED with signal_label Quiet. as_of is the latest thesis touch. latest_theses lists the titles and claims behind that badge. Use depth4_get_thesis when you need the full cascade.

Catalog tools: depth4_list_signals, depth4_get_thesis, depth4_get_feed_updates, depth4_get_signal, depth4_get_copilot_context, depth4_get_daily_digest, depth4_get_account_scope. All are read-only.

Entry timing fields

Zone states: good_entry, pullback_wait, extended, or no_data. Descriptive only — not trade instructions.

Surface	entry_timing	entry_timing_detail
GET /api/asset-signals	state string	full report (label, hint, MA distance)
depth4_list_signals	state string	—
depth4_get_signal	state string	Pro only — full report
depth4_get_daily_digest	Pro: state string; Insider: null	—