Agent Interaction Guidelines

Building AI Agents with the Suna API

SUNA is designed for AI agent consumption from day one.

Use /v1/snapshot Instead of Individual Endpoints

GET /v1/snapshot?days=7&include=meals,scores,state,windows,insights

One call replaces 6+ sequential GETs. More token-efficient.

Read suggestion on Errors

{
  "error": {
    "suggestion": "Swap the values: start_date=2026-03-10&end_date=2026-03-17"
  }
}

Discovery

• llms.txt: suna.health/llms.txt
• OpenAPI: /api/v1/openapi.json

MCP Server (Planned)

Direct LLM integration via Model Context Protocol is planned. Contact echo@suna.health for early access.