SERV Hackathon - RWA Vaults - IXS

CapitalRail

CapitalRail

Check if you can really enter an IXS vault before you sign anything. GO only when deposit capacity is real. How it works · Exit

  1. Tell us
  2. We check
  3. Decision
  4. Review & sign

Where do you want to put your USDC?

Say it in your own words. We check live IXS vaults before you sign anything.

Try:
Your rules:100 USDCAny chainInstant withdrawals onlyNo KYC

Exit

Redeem vault shares

Turn shares back into USDC. CapitalRail prepares unsigned redeem and claim steps - you sign, nothing is custodied.

Connect to see your positions

We scan IXS vaults on BSC and Avalanche for shares held by your wallet.

How it works

From a sentence to signable deposit steps, in six checked steps

CapitalRail is a preflight: it answers "can I actually enter this vault right now?" before any capital moves.

Pipeline

Intent to attested deposit

Idle
  1. 1

    Intent

    you

  2. 2

    Rules

    yours

  3. 3

    Scan

    IXS vaults

  4. 4

    SERV

    decide

  5. 5

    Attest

    deposit

Open path

Awaiting scan

CapitalRail path

Blocked vaults

No blockers yet

Naive AVAX path fails here

  1. 01Chat

    Describe your intent

    Type what you want to deposit in your own words (amount, chain, KYC, withdrawal speed), or edit your rules by hand.

  2. 02SERV

    SERV turns it into your rules

    SERV Reasoning turns your sentence into typed rules validated against a schema. You see what was understood and can edit it.

  3. 03IXS REST + MCP

    Scan the live IXS vaults

    CapitalRail reads the 4 live IX High Yield Bond USDC vaults on BSC and Avalanche through the IXS REST API and MCP tools: access mode, deposit limit, whitelist status and settlement mode (including the daily SGT cutoff for async rails).

  4. 04Code + SERV Reasoning

    Rules are code, judgment is SERV

    Code applies the hard rules (chain, capacity, KYC, withdrawal speed, balance) and sets GO / WAIT / NO-GO. SERV Reasoning then writes fact-grounded risk notes (NAV-staleness limit 0, settlement clock, redemption ops), cross-checks the rules, ranks the vaults that pass and independently verifies the memo. Every step is schema-validated and traced.

  5. 05Guardrail

    Code-level safety override

    Deterministic checks run again after the model. A vault with MCP deposit limit 0 or an unmet whitelist can never be selected, whatever the model says - integrators must not force deposits past limit 0. SERV can veto an entry, never unlock one.

  6. 06Deposit steps

    Review and sign yourself

    Only on GO, and only for your connected wallet, IXS tools build unsigned approve + deposit steps. You sign them in order in your own wallet. Nothing is signed server-side. Async deposits still settle against the next cutoff.

Why CapitalRail

A naive agent would deposit. CapitalRail checks first.

The failure case

The Avalanche IX High Yield Bond USDC vault is listed as open, but MCP can report deposit limit 0. Per IXS ops, that often means NAV staleness or drift - not a permanently closed vault. An agent that only reads "open" (or that forces a deposit past limit 0) would build a transaction that fails.

CapitalRail flags DEPOSIT_LIMIT_ZERO, answers WAIT, and refuses that rail until MCP build succeeds. A code-level override enforces it even if the model disagrees. Min deposit on this Avalanche HYB product is 100 USDC; settlement runs against a daily 5:00 PM SGT cutoff.

  • No custody

    SERV and CapitalRail never hold funds. They read public vault data and return a decision.

  • Nothing signed server-side

    Deposit steps are unsigned and built for your connected wallet only. Only you can sign, after review.

  • Attested snapshot

    Each decision carries a snapshot hash and an attestation time, so you know exactly which IXS state it was based on.

  • Refuses instead of guessing

    If MCP reports deposit limit 0 (often NAV stale, not closed forever), CapitalRail says WAIT and explains why - it never forces an unsafe deposit.

For agents

Call CapitalRail before you allocate.

CapitalRail is a preflight gatekeeper, not a desk. Other agents POST here before sending capital to IXS vaults. Humans use the guided flow above; agents use the same REST surface (and optional MCP) to get GO / WAIT / NO-GO with reasons - then only act on GO. MCP deposit limit 0 may mean NAV staleness (not permanently closed); still treat it as WAIT until build succeeds. Async HYB rails settle against a daily 5:00 PM SGT cutoff.

Agents

Parse intent → run preflight → respect WAIT / NO-GO. Unsigned tx pack only on GO with a real wallet. Preview wallet 0x...0001 for public data.

Humans

Tell us → We check → Decision → Review & sign in the browser. Same checks; the UI adds one-click fixes and wallet signing.

OpenAPI 3 specLive: capitalrail.ozc.fr/openapi.yaml

Set $BASE_URL = https://capitalrail.ozc.fr (or your host)

Security notes

  • No API auth today - rate limited per IP (preflight 6/min, intent 10/min, shared expensive 12/min).
  • Browser cross-site Origin is blocked; curl / server-to-server / MCP (no Origin) are allowed.
  • 429 returns code RATE_LIMITED with Retry-After. Do not weaken limits from agents.
  • Never force a deposit when preflight returns WAIT / DEPOSIT_LIMIT_ZERO - limit 0 can mean NAV stale; CapitalRail waits for a successful MCP build.

curl: POST /api/preflight

Replace $BASE_URL with your host

# CapitalRail preflight - OpenAPI: $BASE_URL/openapi.yaml
curl -s -X POST "$BASE_URL/api/preflight" \
  -H 'Content-Type: application/json' \
  -d '{
    "walletAddress": "0x0000000000000000000000000000000000000001",
    "amount": "1",
    "preferences": {
      "allowKyc": false,
      "requireSyncSettlement": false,
      "preferredChainId": 56
    }
  }'

curl: POST /api/intent

Free text → mandate

# CapitalRail intent - free text to mandate
curl -s -X POST "$BASE_URL/api/intent" \
  -H 'Content-Type: application/json' \
  -d '{ "message": "500 USDC on BSC, no KYC, delayed withdrawals ok" }'

OpenAI-compatible tools

capitalrail_intent + capitalrail_preflight

[
  {
    "type": "function",
    "function": {
      "name": "capitalrail_intent",
      "description": "Parse free-text deposit intent into a CapitalRail mandate (amount, KYC, settlement, optional chain). Call before capitalrail_preflight when the user spoke in natural language.",
      "parameters": {
        "type": "object",
        "additionalProperties": false,
        "required": ["message"],
        "properties": {
          "message": {
            "type": "string",
            "description": "User intent, max 500 characters."
          }
        }
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "capitalrail_preflight",
      "description": "IXS vault entry preflight. Returns GO / WAIT / NO-GO with reasons, risk notes, and a trace. On GO with a real wallet, may include unsigned approve+deposit. Use wallet 0x...0001 for a public preview (no tx pack). Gatekeeper only - do not allocate until GO.",
      "parameters": {
        "type": "object",
        "additionalProperties": false,
        "required": ["walletAddress", "amount", "preferences"],
        "properties": {
          "walletAddress": {
            "type": "string",
            "description": "0x-prefixed EVM address."
          },
          "amount": {
            "type": "string",
            "description": "USDC amount as a decimal string."
          },
          "preferences": {
            "type": "object",
            "additionalProperties": false,
            "required": ["allowKyc", "requireSyncSettlement"],
            "properties": {
              "allowKyc": { "type": "boolean" },
              "requireSyncSettlement": { "type": "boolean" },
              "preferredChainId": {
                "type": "integer",
                "enum": [56, 43114],
                "description": "56 = BSC, 43114 = Avalanche. Omit for any chain."
              }
            }
          },
          "forceRescan": { "type": "boolean" }
        }
      }
    }
  }
]

Anthropic-style tools

Same two tools, input_schema form

[
  {
    "name": "capitalrail_intent",
    "description": "Parse free-text deposit intent into a CapitalRail mandate. Call before capitalrail_preflight when the user spoke in natural language.",
    "input_schema": {
      "type": "object",
      "additionalProperties": false,
      "required": ["message"],
      "properties": {
        "message": {
          "type": "string",
          "description": "User intent, max 500 characters."
        }
      }
    }
  },
  {
    "name": "capitalrail_preflight",
    "description": "IXS vault entry preflight. Returns GO / WAIT / NO-GO. Gatekeeper only - do not allocate until GO. Wallet 0x...0001 = public preview.",
    "input_schema": {
      "type": "object",
      "additionalProperties": false,
      "required": ["walletAddress", "amount", "preferences"],
      "properties": {
        "walletAddress": { "type": "string" },
        "amount": { "type": "string" },
        "preferences": {
          "type": "object",
          "additionalProperties": false,
          "required": ["allowKyc", "requireSyncSettlement"],
          "properties": {
            "allowKyc": { "type": "boolean" },
            "requireSyncSettlement": { "type": "boolean" },
            "preferredChainId": { "type": "integer", "enum": [56, 43114] }
          }
        },
        "forceRescan": { "type": "boolean" }
      }
    }
  }
]

Cursor MCP config

npm run mcp · env CAPITALRAIL_BASE_URL

{
  "mcpServers": {
    "capitalrail": {
      "command": "npx",
      "args": ["tsx", "mcp/server.ts"],
      "cwd": "/absolute/path/to/CapitalRail",
      "env": {
        "CAPITALRAIL_BASE_URL": "https://capitalrail.ozc.fr"
      }
    }
  }
}

Business model

Every failed deposit avoided is worth something.

Failed deposits avoided on this instance

-

Real count from this server, since start

  • 1 · AI agents and wallets

    Preflight API

    One POST /api/preflight call before any deposit returns GO / WAIT / NO-GO, reasons, risk notes and an unsigned tx pack. Agents stop sending transactions that fail.

    Free tier, then pay-per-check

  • 2 · RWA issuers such as IXS

    "Can I enter?" widget + blocked-demand dashboard

    A white-label widget for vault pages, plus a dashboard of demand blocked by capacity, KYC or withdrawal rules, so the issuer sees which limit to raise or which onboarding to push.

    Monthly license per issuer

  • 3 · Allocators on WAIT

    Capacity alerts

    When a vault that fits your rules reports MCP deposit limit 0 (often NAV stale - not closed forever), get notified when build succeeds again, with a fresh preflight attached.

    Subscription

  • 4 · Partner vaults

    Referral on validated deposits

    A routing fee only on deposits that passed the preflight and settled on-chain.

    Subject to an agreement with IXS

Pricing models, not live revenue. The counter above only counts real results served by this server; it resets on restart.

FAQ

Frequently asked questions

© 2026 CapitalRail

SERV Hackathon - IXS entry and exit

Partners

GO only when capacity is real