API Console

What You Get

• 5 MCP tools: get_market_regime, check_trade, get_index_detail, get_signal_changes, get_market_pulse.
• Agent endpoints: /v1/agent/briefing, /v1/agent/context/{ticker}, /v1/agent/openai-tools.
• Every response includes snapshot_id, computed_at, quality flags, and citation metadata.

Quick Health Checks

curl https://marketschema-mcp-production.up.railway.app/health
# {"status":"ok","service":"mcp"}

curl https://api.marketschema.com/v1/agent/openai-tools

Claude Desktop (MCP stdio)

Add the following to your Claude Desktop MCP config, then restart Claude.

{
  "mcpServers": {
    "marketschema": {
      "command": "python3",
      "args": ["-m", "mcp_server.server", "--transport", "stdio"],
      "env": {
        "MARKETSCHEMA_API_BASE_URL": "https://api.marketschema.com",
        "MARKETSCHEMA_AGENT_API_KEY": "ms_agent_your_key_here",
        "MCP_STDOUT_GUARD": "1"
      }
    }
  }
}

Remote MCP (HTTP)

The hosted MCP endpoint is available at https://marketschema-mcp-production.up.railway.app/mcp. Clients must send proper MCP session headers and accept streamable events.

POST https://marketschema-mcp-production.up.railway.app/mcp
Accept: application/json, text/event-stream
Content-Type: application/json

OpenAI Function-Calling Bridge

Load tool schemas dynamically and pass them directly to your model runtime.

{
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_market_regime",
        "description": "Get the current macro regime across 8 categories",
        "parameters": { "type": "object", "properties": {}, "required": [] }
      }
    }
  ]
}

Authenticated Agent Briefing

curl -H "Authorization: Bearer ms_agent_your_key_here" \
  https://api.marketschema.com/v1/agent/briefing

Free keys can call briefing. Agent-scope keys can call full context endpoints.

Related Docs