REST Lens provides a Model Context Protocol (MCP) server for AI-assisted API evaluation.
Quick Start
claude mcp add restlens --transport http https://restlens.com/api/mcp
On first use, you'll be prompted to log in. That's it!
Configuration
Add to your .mcp.json:
{
"mcpServers": {
"restlens": {
"url": "https://restlens.com/api/mcp",
"transport": "http"
}
}
}
Authentication
- OAuth (default): Browser login on first use, tokens persist automatically
- API tokens: For headless usage, add
Authorization: Bearer <token>header
Available Tools
| Tool | Description |
|---|---|
list_projects | List accessible projects |
upload_specification | Upload an OpenAPI spec for evaluation |
await_evaluation | Wait for evaluation to complete |
get_evaluation_status | Check evaluation status |
get_violations | Get API design violations |
list_ignores | List violation ignores |
add_ignore | Suppress a violation |
remove_ignore | Remove an ignore |
Tool parameters are self-documented - your MCP client will show them.
Example
You: Upload /path/to/openapi.yaml to my-org/my-project and show me the violations
Claude: [reads file, uploads spec, waits for evaluation, returns violations]