Project Understanding Tool

API Endpoint Cataloger

Discover and catalog all API routes, endpoints, middleware, and handlers. Know your full API surface area at a glance.

Install

Get the CLI Tool

Catalog API endpoints locally as an MCP server, or try it online below.

npx @clinetools/api-lister
Requires Node.js 18+
  • Discovers routes in Express, Fastify, Next.js, Django, Flask, and Rails
  • Maps middleware chains for each endpoint
  • Identifies handler functions and their source files
  • Groups by resource and detects RESTful patterns
  • Preference conversation — choose output format and grouping style
Tutorial

How to Use It

Map your entire API surface area in seconds.

1

Try Online

Paste Express/Fastify route code and see every endpoint extracted.

↓ Jump to interactive demo
2

Use via CLI

Point at your project root and get a full endpoint catalog.

npx @clinetools/api-lister
3

Add to Cline / Claude Code

Agent catalogs endpoints when working on API changes to see the full surface.

"api-lister": { "command": "npx", "args": ["@clinetools/api-lister"] }

MCP Client Configuration

{
  "mcpServers": {
    "api-lister": {
      "command": "npx",
      "args": ["@clinetools/api-lister"]
    }
  }
}
Live Demo

Try It Online

Paste Express, Fastify, or similar route code to extract all endpoints.

Paste Route Code

We parse Express-style route definitions (app.get, router.post, etc.)

Try a demo:

Paste route code and click Catalog Endpoints to discover all API routes.

Endpoints

Learn

Why API Cataloging Matters

You can't secure, document, or deprecate endpoints you don't know about.

Shadow Endpoints

Forgotten or undocumented endpoints are a security risk. If it's not in your catalog, it's not being monitored, rate-limited, or reviewed. Shadow endpoints are the most common source of API vulnerabilities.

Breaking Change Detection

When you know all your endpoints, you can detect when a change removes or modifies a public API. Without a catalog, breaking changes slip through code review because reviewers don't have the full picture.

Middleware Visibility

Is auth middleware on every endpoint that needs it? Is rate limiting applied consistently? A catalog shows the middleware chain per route, making gaps obvious at a glance.

AI-Ready API Map

AI agents working on your API need to know what endpoints exist. An auto-generated catalog gives agents the context to add new endpoints that follow existing patterns and conventions.

Know Every Endpoint In Your API

Add the API Endpoint Cataloger to your agent's toolkit and never lose track of your API surface.

View Plans