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

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 Desktop, Windsurf)

Next: Authentication →