# Self Bank Platform — Agent-Ready Integration Architecture

## Why this layer exists

The Self Bank platform exposes a dedicated agent-ready integration layer so autonomous agents (LLMs, browser agents, server-side automation) can discover, reason about, and operate selected capabilities under explicit boundaries. The layer is separated from the public marketing surface and from internal banking operations, so agent traffic never touches production-affecting paths by default.

## Integration model

- Sandbox-first: every agent capability is exposed in a controlled simulation environment before any production effect.
- Contract-driven: all interactions conform to a published OpenAPI 3.1 contract.
- Scope-limited bearer auth: agent tokens carry only the scopes required for the use case.
- Audit-by-Design: every agent action is traceable, explainable, and reproducible.
- Human-in-the-loop: irreversible or high-risk operations require human review.

## Initial capability set

- Product and service catalog read
- Onboarding simulation
- Payment validation and routing simulation
- Account-opening lifecycle simulation
- Operational analytics summary (planned capability)

## Adoption path

1. Discover the surface via `/.well-known/api-catalog`, `/agent-index.json`, and the OpenAPI contract.
2. Build against the sandbox base URL `https://cube.self.team/api/agent/v1`.
3. Validate end-to-end coverage and error handling in sandbox.
4. Engage Self Bank to discuss controlled expansion beyond sandbox.

## Control and safety boundaries

- No production side effects from any sandbox capability.
- Scope enforcement on every endpoint; missing scopes return `403`.
- Validation against the OpenAPI contract; invalid bodies return `400`.
- Promotion beyond the sandbox is never automatic and requires explicit Self Bank enablement.

## Planned capability notes

- Operational analytics summary is exposed as a contract artifact and may evolve before general sandbox availability.
- Additional simulation surfaces may be introduced incrementally; new capabilities will appear first as sandbox-only.

## Discovery surface

- `GET /.well-known/api-catalog`
- `GET /.well-known/agent-skills/index.json`
- `GET /.well-known/mcp/server-card.json`
- `GET /api/openapi-agent-v1.yaml`
- `GET /agent-index.json`

## Related resources

- Agent skills: https://cube.self.team/agents/skills
- Agent API: https://cube.self.team/api/agent
- Integration guide: https://cube.self.team/docs/agent-integration
- OpenAPI contract: https://cube.self.team/api/openapi-agent-v1.yaml