Skip to main content

​
API Reference

Rippletide’s current public integration surface is focused on evaluating and connecting agents that you already run.
The legacy agent-builder SDK API is no longer part of the public API Reference. New integrations should use the Evaluation API or MCP.

​
Current APIs

​
Evaluation API

Use the Evaluation API when you want to run test prompts against an agent endpoint and store the results in Rippletide. The fastest supported path is the CLI: 
npx rippletide
For programmatic use, the Evaluation API covers:
  • Checking API service health
  • Creating, listing, reading, updating, and deleting evaluation agents
  • Adding and deleting knowledge items
  • Importing source material from public URLs and PDFs
  • Adding, listing, updating, and deleting evaluation questions
  • Saving, reading, and clearing evaluation results
See the Evaluation API section in this reference for the route details.

​
MCP and Context Graph

Use MCP when your AI client needs persistent memory through Rippletide’s Context Graph. Start with the MCP quickstart:

​
Authentication

Most API requests use an API key in the header: 
x-api-key: your-api-key-here
Some product routes may also accept a signed-in platform session.

​
Legacy SDK API

The old agent-builder SDK surface has been removed from the public API Reference. Do not use it for new integrations unless the Rippletide team has explicitly confirmed that your workspace still depends on it.
  1. Use the CLI if you want to evaluate an agent quickly.
  2. Use MCP if your agent needs persistent memory.