Skip to main content

​
What Trevi accepts

Trevi accepts OpenAPI documents (3.0 or 3.1) in JSON or YAML, and Postman Collections (v2.1) in JSON.

​
Size limits

Uploads are limited to 10 MB. For larger files, import by URL.

​
What Trevi reads

Trevi reads operations, parameters, request bodies, response schemas, and authentication schemes to build tool inputs and outputs.

​
AI intelligence for tool selection

Trevi uses AI intelligence to recommend which operations should be exposed as MCP tools. You can accept the recommendations or refine them in the Server Builder.

​
Required fields that make tools great

  1. Provide a stable operationId for every operation.
  2. Use a clear summary and description.
  3. Add tags to group related operations.
  4. Include request and response schemas with types.
  5. Add examples for complex inputs and outputs.

​
Authentication guidance

Define security schemes for OAuth, API keys, or bearer tokens. If scopes are required, list them on the relevant operations.

​
Postman Collection tips

Use fully qualified URLs in requests. Make sure headers and auth are defined at the collection or request level so Trevi can infer them.

​
Validate before you build

Use Validate a spec to catch errors before creating a server.