API & Integration Documentation

Everything you need to integrate InspectAgents into your AI testing workflow. All endpoints are free with no authentication required.

Quick Start

Get started in 30 seconds. No signup, no API keys needed.

# Search for prompt injection failures
curl -X POST https://inspectagents.com/api/mcp/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0.0"}}}'

REST API

POST /api/agent-feedback

Submit feedback, corrections, or new AI incident reports.

Rate limit: 10 requests/minute per IP

curl -X POST https://inspectagents.com/api/agent-feedback \
  -H "Content-Type: application/json" \
  -d '{
    "type": "incident",
    "message": "AI chatbot leaked internal data",
    "source": "Claude",
    "url": "https://example.com/article"
  }'

Parameters

FieldTypeRequiredDescription
typestringYesfeedback, correction, incident, or suggestion
messagestringYesContent (max 5000 chars)
sourcestringNoAgent identifier (e.g. "Claude", "ChatGPT")
urlstringNoReference URL

GET /api/agent-feedback

Returns self-documenting API docs as JSON. Useful for agent discovery.

MCP Server (Model Context Protocol)

InspectAgents exposes a Streamable HTTP MCP server for direct AI agent integration.

Endpoint

POST https://inspectagents.com/api/mcp/

⚠️ Trailing slash required. Without it, you get a 308 redirect.

⚠️ Accept header required: application/json, text/event-stream

Rate limit: 30 requests/minute per IP

Available Tools

ToolDescription
search_failuresSearch 500+ AI failures by query, category, severity, year
get_failureGet full details of a single failure by ID
assess_riskRun the AI risk assessment quiz
get_checklistRetrieve the 63-point testing checklist
submit_feedbackSubmit feedback or new incidents

Connection Flow

Step 1: Initialize

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0.0"}}}

Step 2: List Tools

{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}

Step 3: Call a Tool

{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_failures","arguments":{"query":"prompt injection","limit":5}}}

Resources (Read-Only)

URIDescription
inspectagents://failures/allComplete failures database as JSON
inspectagents://checklist/fullFull 63-point checklist

Error Handling

All API endpoints return structured JSON errors.

StatusCauseResponse
400Invalid request body or missing fieldsJSON with error details and required fields
404Unknown API endpointJSON with available endpoints
405Wrong HTTP methodJSON with allowed methods
406Missing Accept header (MCP only)Include Accept: application/json, text/event-stream
429Rate limit exceededJSON with rate limit info; X-RateLimit-* headers
500Internal server errorJSON-RPC error with message

Webhooks

Webhook support for real-time notifications is planned. Currently, you can poll the MCP server for updates using search_failures with date filters.

To be notified when webhooks launch, email hello@inspectagents.com.

Discovery & Integration Files

FilePurpose
/llms.txtLLM-optimized site overview
/llms-full.txtFull context with statistics and examples
/api/openapi.jsonOpenAPI 3.1 specification
/.well-known/mcp.jsonMCP server discovery
/.well-known/mcp/server-card.jsonMCP server card
/.well-known/agent-card.jsonA2A Agent Card
/.well-known/ai-plugin.jsonChatGPT Plugin manifest
/.well-known/agent-skills/index.jsonAgent Skills index (v0.2.0)
/.well-known/api-catalogRFC 9727 API catalog
/pricing.mdMachine-readable pricing
/index.mdMarkdown homepage fallback

Rate Limits

EndpointLimitWindow
POST /api/mcp/30 requestsper minute per IP
POST /api/agent-feedback10 requestsper minute per IP
POST /api/subscribe5 requestsper minute per IP

Rate limit info is returned in X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers.

Most teams can't — find out in 2 minutes

500+ AI failures analyzed • 250+ teams protected