# integrations.sh

> A registry of 5,840+ integration specs across MCP, OpenAPI, GraphQL, and CLI formats, grouped by domain and readable by both humans and AI agents.

integrations.sh is an open-source registry built by Rhys Sullivan (UsefulSoftwareCo) that maps publicly-accessible integration surfaces — MCP servers, REST/OpenAPI specs, GraphQL endpoints, and CLIs — for thousands of services, each annotated with credential requirements and setup instructions. The project is licensed under MIT and hosted on Cloudflare Workers, with the site itself exposing a public REST API and MCP server that require no credentials.

## What It Is

integrations.sh is a structured catalog that answers a specific problem for AI agent developers: services expose a fragmented mix of interfaces (MCP, REST, GraphQL, CLI), and while discovering that a service has an MCP server is easy, figuring out exactly which credential it needs and how to acquire it is the part that costs time. The registry solves this by providing one place that lists every publicly-reachable integration surface for a given domain, grouped by format, with authentication details cited and tagged as either `detected` (re-verifiable from a machine signal) or `discovered` (read from the service's docs).

## How the Catalog Works

Each domain page in the registry groups a service's surfaces by format — MCP, REST/OpenAPI, GraphQL, CLI — followed by the shared credentials those surfaces reference. Every surface entry includes:

- **Where it lives**: endpoint, OpenAPI spec, transport, and docs link
- **How to authenticate**: the specific credential needed and step-by-step setup prose to acquire it
- **How trustworthy the answer is**: a `detected` or `discovered` badge on each fact

The catalog is aggregated from public feeds including APIs.guru's OpenAPI directory, Anthropic/Claude's MCP directory, OpenAI's MCP connector directory, a public GraphQL API list, a CLI seed set, and hand-curated OpenAPI additions. The pipeline normalizes these sources via `normalize.ts`, handling deduplication, version collapsing, and favicon fallbacks.

## For Agents: API and MCP Access

The site dogfoods its own model by exposing itself as a catalogued service with a public REST API and a public MCP server — no credentials required. Key endpoints include:

- `GET /api.json` — the entire catalog as a single JSON envelope
- `GET /openapi.json` — OpenAPI 3.1 spec for the REST API
- `GET /api/{domain}/detect` — probes a domain's well-known agent manifests
- `POST /api/{domain}/discover` — LLM-backed full surface mapping for a domain (rate-limited)
- `GET /api/{domain}/surface` — the structured surface document for a domain
- `/mcp` — MCP server exposing `detect` and `discover` tools

## Architecture and Deployment

The project is built with Astro and TypeScript, deployed on Cloudflare Workers with automatic builds triggered on every push to `main`. The local development stack uses Bun as the runtime. Optional environment variables enable the LLM-backed discovery feature (OpenAI API key) and web-search grounding. The catalog files are generated at build time from `sources/` and are gitignored, meaning contributors fix the pipeline rather than individual records.

## Current Status: v0.0.1, Early and Active

The README explicitly describes the project as "early and moving fast (v0.0.1)" with schema and routes subject to change. The GitHub repository shows 183 stars and 15 forks, with the last push recorded in July 2026. At the time of indexing, the site lists 5,840 publicly-accessible integration specs across 2,884 domains, covering 1,282 MCP, 3,867 API, 119 GraphQL, and 572 CLI surfaces.

## Features
- 5,840+ integration specs across MCP, OpenAPI, GraphQL, and CLI formats
- Per-domain credential guides with step-by-step acquisition instructions
- detected/discovered trust badges on every fact
- Public REST API with no credentials required
- Public MCP server exposing detect and discover tools
- LLM-backed domain discovery via POST /api/{domain}/discover
- OpenAPI 3.1 spec for the REST API
- Aggregated from APIs.guru, Anthropic/Claude MCP directory, OpenAI MCP directory, and more
- Hosted on Cloudflare Workers with edge delivery
- MIT-licensed open-source codebase

## Integrations
MCP (Model Context Protocol), OpenAPI / REST, GraphQL, CLI, Cloudflare Workers, Astro, Bun, OpenAI API, APIs.guru, Anthropic Claude MCP directory

## Platforms
WEB, API, CLI

## Pricing
Open Source

## Version
0.0.1

## Links
- Website: https://integrations.sh
- Documentation: https://github.com/UsefulSoftwareCo/integrationsdotsh
- Repository: https://github.com/UsefulSoftwareCo/integrationsdotsh
- EveryDev.ai: https://www.everydev.ai/tools/integrations-sh