Integrations

Aionis is designed to sit beside your Agent host, not replace it. Pick the integration path based on how much control you have over the loop.

Choose A Path

Path	Use when	Start here
TypeScript SDK	You control a Node or TypeScript Agent loop.	TypeScript SDK
MCP bridge	You want Claude Code, Cursor, or another MCP client to try Aionis first.	MCP
Raw HTTP	You need language-neutral integration.	Raw HTTP
Multi-agent host	You run planner, worker, verifier, reviewer, or handoff roles.	Multi-Agent Hosts
External memory	You already use Mem0, Zep, vector DBs, or markdown memory.	External Memory

Core Contract

Every integration eventually maps onto the same product loop:


observe -> guide -> agent action -> feedback -> measure -> snapshot

The host owns execution. Aionis owns memory admission, context compilation, feedback attribution, measurement, and audit replay.

Integration Decision Tree

Question	Recommendation
Do you control the Agent loop code?	Use the SDK.
Do you want a zero-adapter trial in an existing coding Agent?	Use MCP.
Are you integrating from Python, Go, Rust, or a service boundary?	Use raw HTTP.
Do multiple Agents pass work across sessions?	Use the multi-agent host contract.
Do you already have a memory backend?	Keep it and add Memory Firewall through external candidates.

Data You Should Preserve

Whichever path you choose, keep these fields stable:

Field	Why
`tenant_id`	Logical tenant boundary.
`scope`	Project or workspace boundary.
`run_id`	Execution session identity.
`task_signature`	Stable workflow or task identity.
`agent_id`	Agent that produced or consumed evidence.
`team_id`	Shared lane for multi-agent memory.
`guide_trace_id`	Feedback attribution key.

Most failed integrations are not model failures. They are identity and scope mismatches.

What Not To Integrate

Do not make Aionis the tool runner unless you are building a separate host around it. Aionis does not need shell access, browser access, CI access, or model orchestration authority to provide its core value.

Start with Quickstart, then pick the path above.