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 APIsGET /api/v1/providers/search?q= Full-text search across all providers List providersGET /api/v1/providers Paginated index of all API providers Provider detailsGET /api/v1/providers/:slug Metadata, version info Full specGET /api/v1/providers/:slug/spec Complete OpenAPI specification EndpointsGET /api/v1/providers/:slug/endpoints All endpoints for a provider Single endpointGET /api/v1/providers/:slug/endpoints/:method/*path Detailed endpoint info SchemasGET /api/v1/providers/:slug/schemas/:name Schema definitions SummaryGET /api/v1/providers/:slug/summary Generated spec summary Auth requirementsGET /api/v1/providers/:slug/auth Authentication schemes Resolve URLPOST /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 →