Ratel Docs

Send data

Point OpenTelemetry, the Ratel SDK or an MCP client at your instance.

Every API authenticates with a project API key. Create one in Settings > API keys and send it as Authorization: Bearer <key>.

The examples use http://localhost:3000. On a server, use your BASE_URL.

OpenTelemetry

Any OTLP/HTTP exporter works, in any language. Follow Send telemetry with your own address:

SettingValue
Traceshttp://localhost:3000/v1/traces
Logshttp://localhost:3000/v1/logs
HeaderAuthorization: Bearer <your-key>
Protocolhttp/protobuf or http/json

/api/v1/traces and /api/v1/logs are the same routes.

Ratel SDK

Set the endpoint the telemetry guide reads:

export RATEL_OTLP_ENDPOINT="http://localhost:3000/v1/traces"
export RATEL_API_KEY="<your-key>"

The console's Settings > API keys page shows a TypeScript snippet with your address filled in.

MCP

Your agent can query Ratel over MCP: POST <BASE_URL>/api/mcp with the project key as a bearer.

claude mcp add --transport http ratel http://localhost:3000/api/mcp \
  --header "Authorization: Bearer $RATEL_API_KEY"

The console's Integrations page has setup for Claude Code, Claude Desktop, Cursor and VS Code.

On this page