Getting Started

Welcome to openapi.city — structured OpenAPI specifications for AI agents and developers. Search, browse, and query thousands of public API specs via REST API or MCP.

Quick Start

Option A: Agent Signup (Recommended)

Tell your AI agent:

Sign up for openapi.city. Read https://openapi.city/signup.md for instructions.

Your agent will:

1. Ask for your email
2. Create your account and get an API key
3. Configure MCP integration automatically
4. You confirm via email to activate

Option B: Manual Signup

1. Sign up at openapi.city/dashboard and create an account.

2. Generate an API key from the API Keys page.

3. Make your first request:

curl -H "Authorization: Bearer oac_live_YOUR_KEY_HERE" \
  https://openapi.city/api/v1/providers/search?q=stripe

4. Browse the response:

{
  "results": [
    {
      "slug": "stripe",
      "name": "Stripe",
      "description": "Online payment processing for internet businesses",
      "category": "payments",
      "endpoint_count": 243
    }
  ],
  "endpoint_matches": [],
  "meta": { "page": 1, "per_page": 25, "total": 1, "total_pages": 1 }
}

What you can do

Feature	Endpoint	Description
Search APIs	GET /api/v1/providers/search?q=	Full-text search across all providers
List providers	GET /api/v1/providers	Paginated index of all API providers
Provider details	GET /api/v1/providers/:slug	Metadata, version info
Full spec	GET /api/v1/providers/:slug/spec	Complete OpenAPI specification
Endpoints	GET /api/v1/providers/:slug/endpoints	All endpoints for a provider
Single endpoint	GET /api/v1/providers/:slug/endpoints/:method/*path	Detailed endpoint info
Schemas	GET /api/v1/providers/:slug/schemas/:name	Schema definitions
Summary	GET /api/v1/providers/:slug/summary	Generated spec summary
Auth requirements	GET /api/v1/providers/:slug/auth	Authentication schemes
Resolve URL	POST /api/v1/resolve	Ingest a new spec by URL

Two integration paths

• REST API — standard HTTP requests, ideal for scripts, backends, and tools
• MCP Server — native integration with AI coding assistants (Cursor, Claude Code, Windsurf)

Next: Authentication →