# Mercurius

> Agentic Risk Firewall — pre-execution margin validation for autonomous AI trading agents.
> Validates proposed trades against RegT, Portfolio Margin, and SPAN rules.

## Docs

- [OpenAPI Schema](https://mercurius.igniteedge.ai/openapi.json): Full API specification
- [MCP Server](https://mercurius.igniteedge.ai/mcp): Model Context Protocol — auto-discovered tools from OpenAPI

## Free Endpoints

- [Service Info](https://mercurius.igniteedge.ai/v1/info): GET — service metadata and capabilities
- [Health](https://mercurius.igniteedge.ai/health): GET — service health check

## Paid Endpoint (x402 — USDC on Base Sepolia)

- [Evaluate Trade](https://mercurius.igniteedge.ai/v1/evaluate): POST $0.01 — submit AgentIntent, receive AUTHORIZED/BLOCKED/DEGRADED with margin analysis

## x402 Payment Flow

`POST /v1/evaluate` returns HTTP 402 with a `payment-required` header (base64 JSON).
To pay: decode the header, sign an EIP-712 typed-data message with your wallet,
and resend the request with the signed payment in the `X-PAYMENT` header.
The x402 facilitator (https://x402.org/facilitator) settles the on-chain transfer.
Network: Base Sepolia (eip155:84532). Asset: USDC.

## Example AgentIntent

```
POST /v1/evaluate
Content-Type: application/json
X-PAYMENT: <base64-signed-payment>

{
  "account": {"account_id": "A1", "trading_funds_type": "MARGIN", ...},
  "order_legs": [{"symbol": "AAPL", "instruction": "BUY", "quantity": 100, ...}]
}
```

## Authentication

- HMAC-SHA256 signed tokens returned on AUTHORIZED decisions (5-min TTL)

## UCP (Universal Commerce Protocol)

- [Capabilities](https://mercurius.igniteedge.ai/v1/ucp/capabilities): GET — discover available tiers and margin capabilities (free)
- [Negotiate](https://mercurius.igniteedge.ai/v1/ucp/negotiate): POST — negotiate capabilities for a proposed request (free)
- [Agent Credential](https://mercurius.igniteedge.ai/v1/ucp/agent/{agent_id}/credential): GET — resolve agent tier and permissions