
OpenAPI.city
from baryhuang
Precise API context for AI agents, via MCP and REST.
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 โ
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:
-
Ask for your email
-
Create your account and get an API key
-
Configure MCP integration automatically
-
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 }
}
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITโ you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub โ