Blog

How do you make your API product usable by agents?

Originally published on LinkedIn, September 10, 2025.

Agents are coming for your API product. The checklist for your roadmap: complete API coverage, a usable search endpoint, and ten more items.

In the coming months, you’ll want to make sure your API Product is usable by Agents.

Here’s your checklist to plan your Q4 and 2026 Product Roadmap:

API PRODUCT

  1. Complete coverage of your public API.
  2. Have a usable Search endpoint.
  3. Improve your API’s quality, consistency, and adherence to standards.
  4. Match available APIs to desired use cases.
  5. Reduce API complexity! Limit API scope to minimize context size.

API DESIGN

  1. Overhaul your adherence to protocols, standards & conventions.
  2. Name things right. This helps LLMs and agents figure out your API.
  3. Return relevant, clear errors, and use RFC 9457 (Problem Details).
  4. Build Experience APIs. Don’t just CRUD your database objects.
  5. Slim down schema nesting & reduce complexity.

MACHINE-READABLE DOCUMENTATION

  1. Publish detailed and accurate API Descriptions such as OpenAPI 3.1+
  2. Implement a process to version, validate, and test your API Descriptions.
  3. Review your API documentation for complete coverage of your API.
  4. Provide code examples and describe workflows.
  5. Clearly document the use of required fields.

MCP SERVERS

  1. Ship an MCP Server that you maintain and control to & publish to Registries.
  2. Test your MCP tools and underlying APIs with LLMs and Agents.
  3. Aggregate APIs instead of requiring Agents to make multiple calls.
  4. Ship multiple MCP Servers for different domains and use cases.
  5. Evaluate user prompts with an inspector like MCPJam.

INFRASTRUCTURE

  1. Set up self-serve, instant provisioning.
  2. Use standard authentication methods.
  3. Secure your MCP Servers and ensure tools respect authorization.
  4. Get ready for spikes in traffic.
  5. Implement usage-based billing to anticipate agents paying for tool use.

In a nutshell: Simplify your APIs and prepare your infrastructure.

Get a hi-res printable version of the checklist and learn more about my course, Build AI-Ready APIs on Maven: https://lnkd.in/gc3PQgsH