MCP Server Reference

01 / QUICKSTART

Connect a client

Nexus uses MCP Streamable HTTP. Add server URL and bearer header to any compliant client.

Keep tokens out of source control.Read bearer value from environment or client secret storage. Never place it in frontend code.

Standard JSON configuration

{
  "mcpServers": {
    "nexus": {
      "type": "http",
      "url": "https://mcp.omnific.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${NEXUS_MCP_TOKEN}"
      }
    }
  }
}

Claude Code

claude mcp add --transport http nexus https://mcp.omnific.dev/mcp \
  --header "Authorization: Bearer $NEXUS_MCP_TOKEN"

Codex

codex mcp add nexus \
  --url https://mcp.omnific.dev/mcp \
  --bearer-token-env-var NEXUS_MCP_TOKEN

02 / AUTHENTICATION

Bearer token

Every MCP request requires HTTP Authorization. Server route stays unmounted when deployment has no configured MCP bearer token.

AuthorizationBearer $NEXUS_MCP_TOKENrequired

03 / RECOMMENDED FLOW

Start broad. Drill down.

1Frame backdropget_regime

Computed regime and weighted contributions.

2Inspect driverget_insights

Liquidity, credit, curve, rates, or stress.

3Add market contextget_quotes

Current levels and daily moves.

4Explain changeget_signal_events

Threshold crossings and before/after state.

04 / TOOL REFERENCE

16 typed tools

get_regimeREAD

Overall computed liquidity/credit regime verdict. Best first call for macro-backdrop questions.

readOnlyHinttrue

No arguments.

get_insightsREAD

Computed liquidity, credit, curve, rates, stress, or alert detail.

readOnlyHinttrue

kindstringrequired

include_seriesbooleanoptional

Include 90-day net-liquidity series; default false.

get_insight_historyREAD

Daily insight snapshots across a date range, capped at 92 days.

readOnlyHinttrue

fromstringoptional

Start date YYYY-MM-DD.

tostringoptional

End date YYYY-MM-DD.

get_signal_eventsREAD

Discrete regime, credit, curve, and alert threshold events.

readOnlyHinttrue

event_typestringoptional

Optional event type.

limitintegeroptional

Default 10, maximum 50.

get_correlationREAD

Rolling cross-asset correlation matrices.

readOnlyHinttrue

windowsinteger[]optional

Trading-day windows such as [30, 90].

get_cross_signalsREAD

Prediction venue, CFTC, expiry, momentum, and liquidity anomalies.

readOnlyHinttrue

signal_typestringoptional

Optional signal-list filter.

limitintegeroptional

Items per list; default 10, maximum 50.

get_cftcREAD

Latest CFTC positioning, normalized flows, z-scores, and squeeze signals.

readOnlyHinttrue

symbolstringoptional

Contract symbol such as ES, GC, or 6E.

limitintegeroptional

Default 10, maximum 50.

get_sentimentREAD

Crypto, stock, and gold Fear & Greed readings.

readOnlyHinttrue

daysintegeroptional

History per index; default 7, maximum 50.

get_quotesREAD

Current price, daily change, market status, and freshness.

readOnlyHinttrue

symbolsstring[]required

Up to 20 symbols.

get_market_historyREAD

Daily history for tracked major assets.

readOnlyHinttrue

symbolsstring[]optional

Optional tracked-symbol filter.

days_backintegeroptional

Default 30, maximum 365.

get_economic_calendarREAD

Macro events with actual, forecast, prior, importance, and time.

readOnlyHinttrue

countrystringoptional

ISO country code.

limitintegeroptional

Default 10, maximum 50.

get_market_stateREAD

Latest narrative market HUD, asset diagnostics, and lookahead radar.

readOnlyHinttrue

No arguments.

get_daily_reportREAD

Daily research report, key news, and trading notes.

readOnlyHinttrue

datestringoptional

Date YYYY-MM-DD; latest when omitted.

summary_onlybooleanoptional

Omit full report text.

search_reportsREAD

Full-text report archive search with compact snippets.

readOnlyHinttrue

querystringrequired

Search needle.

report_typestringoptional

Optional report type.

fromstringoptional

Start date.

tostringoptional

End date.

pageintegeroptional

1-based page.

page_sizeintegeroptional

Default 10, maximum 50.

search_newsREAD

Curated headline and OSINT search before general web search.

readOnlyHinttrue

querystringoptional

Optional text or symbol needle.

typestringoptional

normal | breaking | osint

fromstringoptional

Start date or RFC3339.

tostringoptional

End date or RFC3339.

pageintegeroptional

1-based page.

page_sizeintegeroptional

Default 10, maximum 50.

get_market_wrapREAD

Asia, Europe, or US session recap.

readOnlyHinttrue

datestringoptional

Date YYYY-MM-DD; latest when omitted.

sessionstringoptional

asia | europe | us

05 / ERRORS & LIMITS

Predictable failure modes

30stool-call timeout

10default list size

50maximum list size

Tool failures return MCP tool errors with a short recovery hint. Retry errors marked retryable; correct invalid symbols, dates, filters, or required inputs before retrying validation errors.

Market context,native to your agent.

Connect a client

Standard JSON configuration

Claude Code

Codex

Bearer token

Start broad. Drill down.

16 typed tools

Predictable failure modes

Market context,
native to your agent.