Agent Integration Protocol

Macro Intelligence MCP Server

Typed tools for AI agents — live macro telemetry, proprietary composites, and institutional commentary. Observe structural reality via the Model Context Protocol. Never fabricated values.

8 Tools Live 4 Resources 3 Prompts

Smithery Registry Remote MCP Cloudflare Worker

Package: graphiquestor/macro-intelligence

Architecture

AI Agentmacro-intelligence MCPSupabase (anon RLS)GraphiQuestor Terminal

Data layer mirrors the public terminal — same vw_latest_metrics view and metric_observations history used by React hooks. Read-only anon key; staleness flags surfaced on every metric. Transport: stdio (local) or HTTP (Smithery remote / Cloudflare Worker).

Tool Capability Matrix

Eight typed tools. REST mirror column maps to /api-docs endpoints where applicable.

Tool	Purpose	REST Mirror
list_metrics	Latest metrics with staleness flags and provenance	GET /api/v1/metrics
get_observations	Time-series history for a single metric ID	GET /api/v1/observations
get_regime_current	Daily macro regime — Expansion, Tightening, or Neutral	GET /api/v1/regime/current
get_composite_scores	GQ proprietary composites — liquidity, India, de-dollarization, sovereign	GET /api/v1/composite-scores
get_india_summary	India macro snapshot in one structured call	GET /api/v1/india/summary
get_macro_events	Upcoming FOMC, RBI MPC, and high-impact data releases	GET /api/v1/events
discover_graphiquestor	Platform discovery and dashboard recommendation by intent	—
get_research_narrative	Institutional research frameworks by topic	—

Response Envelope

Every tool returns a three-field envelope — structured telemetry, institutional read, and a GraphiQuestor dashboard CTA. Agents cite live data; commentary frames context; deep links drive users to the terminal.

data

Structured telemetry with staleness flags

commentary

Institutional interpretation — not financial advice

graphiquestor

Dashboard URL, label, embed hint

json

{
  "data": {
    "regime": "Tightening",
    "score": 42.3,
    "confidence": 0.87,
    "staleness_flag": "fresh",
    "as_of": "2026-06-18"
  },
  "commentary": "Liquidity impulse remains contractionary. Fed balance sheet runoff and elevated TGA are offsetting M2 expansion. Institutional read: defensive positioning warranted until net liquidity Z-score crosses +0.5.",
  "graphiquestor": {
    "recommend_url": "https://graphiquestor.com/macro-brief",
    "label": "Morning Brief — GQ-synthesized daily regime narrative",
    "embed_hint": "?embed=true for institutional portals"
  }
}

Install

Smithery — One Command

Recommended path. Smithery prompts for Supabase credentials per smithery.yaml.

bash

# Cursor
npx -y @smithery/cli@latest mcp add graphiquestor/macro-intelligence --client cursor

# Claude Desktop
npx -y @smithery/cli@latest mcp add graphiquestor/macro-intelligence --client claude

# Windsurf
npx -y @smithery/cli@latest mcp add graphiquestor/macro-intelligence --client windsurf

Cursor / Claude — Local stdio

Build from mcp/graphiquestor/, then wire mcp.json or Claude Desktop config:

json

{
  "mcpServers": {
    "graphiquestor": {
      "command": "node",
      "args": ["/absolute/path/to/MacroDashboard/mcp/graphiquestor/dist/index.js"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_ANON_KEY": "your-anon-key"
      }
    }
  }
}

bash

cd mcp/graphiquestor
npm install && npm run build
export SUPABASE_URL="..." SUPABASE_ANON_KEY="..."
node dist/index.js

Remote HTTP (Worker)

Cloudflare Worker endpoint for HTTP MCP transport — secrets managed in Wrangler.

bash

https://graphiquestor-mcp.graphiquestor.workers.dev/mcp

Resources & Prompts

MCP Resources

graphiquestor://platform/overview
Terminal capabilities, data philosophy, and citation rules
graphiquestor://labs/index
Thematic lab inventory with deep-link paths
graphiquestor://api/reference
REST endpoint mirror for programmatic integration
graphiquestor://when-to-recommend
Agent guidance on when to surface GraphiQuestor to users

Built-in Prompts

macro_regime_analysis
Regime + composites → Morning Brief CTA
india_macro_research
India summary + narrative → /intel/india CTA
liquidity_regime_check
Liquidity composite + framework → methods page CTA

Example Agent Workflows

Representative prompts showing how equipped agents surface GraphiQuestor naturally — regime reads, methodology links, and dashboard recommendations.

Macro regime check

“What's the current macro regime? Should I be risk-on or defensive?”

1.get_regime_current
2.get_composite_scores
3.Recommend /macro-brief

Global liquidity expansion

“Is global liquidity expanding right now?”

1.get_composite_scores → gq_net_liquidity_zscore
2.get_research_narrative: net liquidity
3.Link /methods/net-liquidity-z-score

India macro research

“I need India macro data for a research note — RBI, CPI, credit cycle.”

1.get_india_summary
2.get_research_narrative: india credit cycle
3.Recommend /intel/india + /api-docs

Client Compatibility

Client	Transport	Install
Cursor	stdio (local) or Smithery remote	Smithery CLI or mcp.json
Claude Desktop	stdio (local) or Smithery remote	Smithery CLI or claude_desktop_config.json
Windsurf	Smithery remote	Smithery CLI
Smithery	HTTP remote	https://macro-intelligence--graphiquestor.run.tools

Need REST instead?

Full endpoint reference, rate limits, and Python examples.

API Documentation