# Bruno — API Agent Score

> Score: 76/100 (Grade: B) | Domain: usebruno.com | Rubric: 1.0.0 | Checked: July 30, 2026

Bruno scored 76/100 (B), classified "partially-ready".

[View full report](https://www.postman.com/ai/ai-ready-apis/company/usebruno)
[All organizations](https://www.postman.com/ai/ai-ready-apis/llms.txt)

## Summary

- Overall: 76/100 (B)
- Classification: partially-ready

## Category Scores

- API Design: 94/100 (A+)
- Developer Experience: 85/100 (A)
- Agent Discovery: 92/100 (A+)
- Agent Understanding: 64/100 (C)
- Agent Usability: 56/100 (D)

## Check Results

### API Design

- [pass] Schema coverage & depth — .d.ts present on disk but not declared in package.json. Investigated: sdk 100%, spec 50%.
- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: spec 100%, docs 100%, cli 0%.
- [warn] Machine-readable, versioned contract — info.version="1.0.0" set but no versioning scheme (URL / header / media type) detected. Investigated: spec 75%, cli 75%, docs 50%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 0%.
- [pass] Example coverage — README is present and includes a runnable quickstart. Investigated: sdk 100%, cli 100%, spec 0%, docs 0%.

### Developer Experience

- [pass] Self-service developer portal — Signup page at https://docs.usebruno.com/get-started/bruno-basics/download (CSR-rendered — body classifier inconclusive); free tier / sandbox documented in pricing/docs. Investigated: docs 100%.
- [pass] Quickstart present — Quickstart at https://docs.usebruno.com/get-started/bruno-basics/download with a runnable first-call sample. Investigated: docs 100%.
- [pass] Description completeness — 100% of operations + parameters have substantive descriptions. Investigated: spec 100%.
- [pass] Changelog published — Newest official SDK activity 0 day(s) ago. Investigated: sdk 100%, spec 0%, docs 0%.
- [fail] Code samples in docs — No detectable code samples across 20 sampled docs pages. Investigated: docs 0%.

### Agent Discovery

- [pass] Registry & SDK presence — Indexed on Context7 (usebruno/bruno-docs, 1706 snippets). Investigated: docs 100%, sdk 25%, cli 0%.
- [warn] Docs reachable, not hard auth-gated — 1 of 50 sampled pages require authentication (49 accessible). Investigated: docs 90%.
- [warn] llms.txt present, valid & comprehensive — llms.txt covers 192/531 sitemap doc pages (36%); 339 missing; 1 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap). Investigated: docs 81%, sdk 0%.
- [pass] Crawlable / AEO — Docs paths crawlable by all monitored AI agents. Investigated: wellknown 100%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — Only 1 distinct 4xx/5xx codes documented (plus 0 "default" catch-all responses). Investigated: docs 100%, spec 50%, cli 0%.
- [warn] Agent-navigable, token-efficient docs — 8 of 50 pages have minor content differences between markdown and HTML. Investigated: docs 85%.
- [pass] Docs structured data — JSON-LD Article markup on 17/18 assessed pages (94%) with dateModified present (1 JS-rendered). Investigated: docs 100%.
- [fail] Operation purpose clarity — 0% of operations are agent-inferable. Investigated: spec 0%.
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.
- [fail] Description consistency across surfaces — Mean pairwise description similarity across 2 surfaces (spec, sdk) is 0% (threshold 35% for full credit).

### Agent Usability

- [pass] Pagination documented & consistent — Pagination params detected on 1 list endpoint(s). Investigated: docs 100%, spec 75%.
- [pass] Sandbox separation — Sandbox server declared but no distinguishable test credentials in scheme descriptions. Investigated: spec 100%, docs 100%, sdk 100%.
- [fail] Idempotency documented — 0% of mutating operations document idempotency. Investigated: spec 0%, docs 0%, sdk 0%, cli 0%.
- [fail] Rate-limit signaling — No rate-limit response headers documented. Investigated: spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

Usebruno's API program has strong foundations in API design and discoverability, but partners and their AI agents face a significant gap in understanding and executing against your APIs. The two areas that most threaten partner adoption are agent understanding — where operation intent, contextual guidance, and description consistency are all missing — and agent usability, where partners cannot run real workflows or trust reliability behaviors like idempotency and rate limiting. Prioritize giving agents and partners the context and executable confidence they need to integrate successfully without manual hand-holding.