Introduction
Maetra keeps AI agents inside the lines at runtime. Anchor long-running work to an active Task Guard contract, put a checkpoint in front of sensitive actions, and put a scanner in front of prompts, tool calls, and outputs — over a plain REST API or an MCP server.
New to Maetra? Start with the Quickstart. Just need a reference? Jump to the API reference.
The three runtime controls#
Task Guard
AI agent task alignment. Turn the user's objective, constraints, scope, and success criteria into an active task contract. Before a material action, Task Guard checks whether the work is aligned, supporting, needs an explanation, requires user confirmation, or should be refocused. Afterward, it can compare expected and reported effects.
Govern
Human-in-the-loop approvals. Before an agent does something consequential - move money, delete data, email a customer - it calls Maetra. Your exact policies or AI agent decision intelligence decide: auto-approve, auto-block, or route to a human. The agent gets a decision plus a signed token it can present as proof the action was authorised.
Secure
Runtime content scanning. Screen prompts, tool calls, and model outputs against your workspace rules — prompt injection, data exfiltration, disallowed tools — and get back a verdict (safe, flagged, blocked) and a recommended action. Anything flagged or blocked becomes an incident.
Two ways to integrate#
| Interface | Best for | |
|---|---|---|
| REST API | Backends and services calling /v1 over HTTPS. | Quickstart → |
| MCP server | AI agents and assistants that speak the Model Context Protocol. | MCP overview → |
Both are backed by the same evaluation engine and authenticated with the same workspace API key.
Good to know You don't need to register your agents first. Every endpoint accepts a free-text
agent_name, so you can integrate in minutes and register agents later for richer reporting. Govern still evaluates API-only and MCP agents against organization-wide policies; whenagent_nameoragent_idmatches a registered agent, agent-scoped policies can apply. See Agents.
Base URL#
https://api.maetra.io
All REST endpoints are versioned under /v1. The MCP server has its own base URL — see the MCP overview.
Next steps#
- Create an API key in the dashboard.
- Run your first checkpoint and scan, or start a Task Guard task.
- Browse the full API reference.