Concepts

Architecture

Infrastructure planesTilcAI
  1. 01 / Communication
    MCPSDKHTTP API
  2. 02 / Authority and control
    Tenant + policiesAuthorizationQuote
  3. 03 / Financial execution
    CCTP / x402OZ RelayerStellar / EVM
SQLite · Persisted states + worker + reconciliation

Three planes separate conversation, authority and financial execution. The model helps with intent; rules and the signer control money.

Responsibilities and dependencies

Component map
ComponentResponsibility
MCP / SDK / HTTPIntegration entry points; they do not replace the signer.
API · tenantsAuthentication, scopes, quotes, attempts and accounts.
Worker · SQLitePersisted states, resumption and reconciliation of payments and disbursements.
OpenZeppelin Relayer · RedisTransaction submission and sponsored gas. Redis belongs to relayer operations.
Circle CCTP V2 · IrisNative USDC burn, attestation and mint.
Stellar / EVMExecution and on-chain evidence; not equivalent to commercial confirmation.
Business / fiat providerExternal source of inventory, price, bank payment and fulfillment.

Repositories and boundaries

tilcai-core defines shared contracts and policies; tilcai-infrastructure implements the backend and adapters; tilcai-sdk and tilcai-mcp consume it; tilcai-cctp-engine is a route laboratory; tilcai-web documents and monitors.

Availability depends on your instance. Check /health and /v1/routes before integrating.

TilcAI Docs · 20 Oct 2026Sources and versions ↗