Integrate Agentic Suite
Agentic Suite is a platform for building, running, and composing AI agents and workflows. This section is for anyone integrating it into their own product, internal tools, or another agent system: a company standardizing on agents, a team wiring agents into their stack, or an individual calling the API directly.
There are four ways to integrate, and they compose. Pick the one that matches what you are building.
Four integration paths
1. Agents over the API
Create an agent once, then execute it on demand from your own code. Each run is
asynchronous: you submit a task, get an execution_id back, and either poll for
the result or stream events as they happen. This is the path for embedding an
agent into a backend, a cron job, or a product feature.
Start at Agents.
2. Agent to agent (A2A)
Have agents call other agents. Two models are available:
- Orchestration runs several of your own agents together under one request, using a sequential, parallel, hierarchical, or auto-selected strategy.
- A2A federation exposes an agent as a discoverable endpoint so agents in
other systems (or other organizations) can find and invoke it over the open
A2A protocol, with an agent card at
/.well-known/agent.json.
Start at Agent to agent.
3. MCP (Model Context Protocol)
Connect through MCP in both directions:
- Agentic Suite as an MCP server exposes your published flows as callable tools to any MCP client, including Claude Desktop.
- External MCP servers as tools lets your agents call tools hosted on other MCP servers you register.
Start at MCP.
4. Direct REST API
Everything above is REST under the hood. If you just want to script the platform, the API covers agents, orchestration, flows, integrations, and runs. Every endpoint is documented interactively.
Start at Authentication, then browse the live API
reference at /api/docs on your backend.
How the pieces fit
| You want to… | Use |
|---|---|
| Run one agent from your backend | Agents API |
| Coordinate several agents on one goal | Orchestration |
| Let another system discover and call your agent | A2A federation |
| Expose your workflows as tools to an MCP client | MCP server |
| Give your agents tools hosted elsewhere | MCP integration |
| Script anything on the platform | REST API |
Base URLs
| Surface | Hosted | Local (docker compose) |
|---|---|---|
| API | https://api.agenticsuite.app | http://localhost:8002 |
| App (UI) | https://agenticsuite.app | http://localhost:3002 |
| Docs | https://agenticsuite.io | http://localhost:4321 |
All REST endpoints live under /api/v1. Interactive API docs are served at
/api/docs on the backend.
Next: Authentication.