UsefulSoftwareCo/integrationsdotsh

This project addresses the fragmentation of service integration interfaces (MCP, REST/OpenAPI, GraphQL, CLIs) by providing a unified, machine-readable map of thousands of services. It targets AI agents and developers, simplifying the discovery and authentication process for diverse service integrations, thereby enhancing agent capabilities and accelerating development workflows.

How It Works

integrations.sh acts as a central registry, mapping services to their publicly reachable integration surfaces. For each surface, it details the required credentials and provides actionable setup prose. The core advantage lies in its focus on the authentication challenge, offering "grounded, cited credential guides." It distinguishes between "detected" (machine-verifiable) and "discovered" (documentation-based, potentially LLM-enhanced) facts, providing a signal of trustworthiness. Both the human-readable website and the machine-readable JSON API serve the same underlying data.

Quick Start & Requirements

• Primary Install/Run: Uses bun. Install dependencies with bun install. Run the local development server with bun run dev. Build for production with bun run build.
• Prerequisites: Bun runtime. Cloudflare Workers environment is recommended for full functionality; wrangler dev is used for local Worker emulation. Optional API keys: OPENAI_API_KEY for LLM-backed discovery, CONTEXT_DEV_API_KEY for web-search grounding.
• Links: Main site/API: https://integrations.sh. Full catalog: https://integrations.sh/api.json. API specification: https://integrations.sh/openapi.json. Hosted MCP server: https://integrations.sh/mcp.

Highlighted Details

• Offers a public REST API (e.g., GET /api.json, GET /api/{domain}/detect, POST /api/{domain}/discover) and a hosted MCP server for programmatic access.
• Integration surfaces are categorized by format (MCP, REST/OpenAPI, GraphQL, CLI) and annotated with authentication binding details and trustworthiness signals.
• The catalog is aggregated from multiple public feeds including APIs.guru, Anthropic, OpenAI, and public GraphQL APIs, supplemented by manual additions.
• Automated deployments to Cloudflare Workers are triggered on pushes to the main branch.

Maintenance & Community

The project is marked as "Early and moving fast (v0.0.1)," indicating potential for schema and route changes. No specific community channels (like Discord/Slack) or notable contributors/sponsorships are detailed in the README.

Licensing & Compatibility

• License: MIT.
• Compatibility: The MIT license is permissive, generally allowing for commercial use and integration within closed-source projects.

Limitations & Caveats

As an early-stage project (v0.0.1), schema and API routes are subject to change. Advanced discovery features (discover endpoint) require an OpenAI API key. Full live discovery and MCP server functionality are dependent on the Cloudflare Workers deployment. The README does not specify a bus factor or detailed migration plans.