Skip to main content

Agent Interfaces

b1e55ed exposes three real-time interfaces for AI agents:

SSE event stream

Returns a Server-Sent Events stream. Reconnect is safe — use ?since=<event_id> to resume. Query params:
  • domain — filter by event domain (e.g. signal, alert, learning)
  • since — resume from a specific event ID (inclusive)
Event format:
Example (curl):

MCP server

Standard MCP JSON-RPC 2.0 server.
List available tools:
Available tools:
  • get_brain_status — current regime, kill switch level, last cycle
  • get_recent_signals — recent signal events with optional domain filter
  • get_open_positions — open positions with P&L
  • get_signal_attribution — attribution data for a specific signal
  • emit_producer_signal — emit a signal event from an agent producer
  • b1e55ed_provenance_check — check producer lineage before acting on a signal

Signal attribution

Returns attribution data for a specific signal: contributor, source, outcome if settled.

Capabilities discovery

Returns what this instance supports — MCP tools, event domains, and producer capability entries (signal types + health). Use for agent onboarding.

Trace sessions

For agents that need stateful interaction tracking:
Sessions are lightweight. They track which agent is interacting, when, and what they’ve seen.

Producer feedback

Agents can report signal outcomes back to the engine:
This feeds the learning loop.

Oracle (no auth)

The oracle endpoint requires no authentication and is safe to expose publicly:
See: oracle.md for full documentation.