---
title: "Retrace developer resources"
description: "Index of every Retrace programmatic interface: REST API, OpenAPI spec, MCP servers, SDKs, CLI, webhooks, and agent discovery documents."
canonical: "https://retraceai.tech/developers"
last-updated: 2026-08-26
format: text/markdown
---

# Retrace developer resources

Every programmatic interface Retrace exposes, at a predictable URL. Start here if you are an AI agent deciding how to integrate.

## API

- REST API base URL: https://api.retraceai.tech
- OpenAPI 3.1 specification: https://retraceai.tech/openapi.json
- API reference: https://docs.retraceai.tech/api-reference
- API catalog (RFC 9727): https://retraceai.tech/.well-known/api-catalog
- OpenTelemetry ingest: POST https://api.retraceai.tech/v1/traces
- Live span stream: wss://api.retraceai.tech/ws/v1/stream
- Batch operations: POST https://api.retraceai.tech/api/v1/batch
- Async job status: GET https://api.retraceai.tech/api/v1/jobs/{id}

## Authentication

- Agent credential walkthrough: https://retraceai.tech/auth.md
- Protected resource metadata (RFC 9728): https://api.retraceai.tech/.well-known/oauth-protected-resource
- Authorization server metadata (RFC 8414): https://auth.retraceai.tech/.well-known/oauth-authorization-server
- Human authentication guide: https://retraceai.tech/developers/authentication
- API keys begin with `rt_` and are sent as `Authorization: Bearer rt_...`.

## MCP

- Product MCP server (Streamable HTTP, authenticated): https://api.retraceai.tech/mcp
- Documentation MCP server (Streamable HTTP, public): https://api.retraceai.tech/mcp/docs
- MCP discovery: https://retraceai.tech/.well-known/mcp
- MCP server card: https://retraceai.tech/.well-known/mcp/server-card.json
- Setup guide: https://retraceai.tech/developers/mcp-server

## SDKs and CLI

- Python SDK: https://retraceai.tech/developers/sdk-python.md
- TypeScript SDK: https://retraceai.tech/developers/sdk-typescript.md
- API Reference: https://retraceai.tech/developers/api-reference.md
- Authentication: https://retraceai.tech/developers/authentication.md
- Webhooks: https://retraceai.tech/developers/webhooks.md
- MCP Server: https://retraceai.tech/developers/mcp-server.md
- CLI: https://retraceai.tech/developers/cli.md
- Python package: `pip install retrace-sdk` (https://pypi.org/project/retrace-sdk/)
- TypeScript package: `npm install retrace-sdk` (https://www.npmjs.com/package/retrace-sdk)
- CLI: `curl -fsSL https://retraceai.tech/install.sh | sh`

## Webhooks

- Outbound event delivery (eval-rule webhooks): https://retraceai.tech/developers/webhooks
- Outbound delivery is HTTPS-only and blocks private/internal addresses.

## Agent discovery documents

- Agentic resource catalog: https://retraceai.tech/.well-known/ai-catalog.json
- Agent skills index: https://retraceai.tech/.well-known/agent-skills/index.json
- A2A agent card: https://retraceai.tech/.well-known/agent-card.json
- Universal Commerce Protocol profile: https://retraceai.tech/.well-known/ucp
- Web Bot Auth key directory: https://retraceai.tech/.well-known/http-message-signatures-directory
- NLWeb ask endpoint: POST https://retraceai.tech/ask
- LLM instructions: https://retraceai.tech/llms.txt
- Scoped LLM instructions: https://retraceai.tech/api/llms.txt, https://retraceai.tech/developers/llms.txt
- Repository agent configuration (AGENTS.md, plugin.json, skills/): https://github.com/Retraceai-tech/retrace-sdk