diff --git a/fern/ai-tools/integrations-sh.mdx b/fern/ai-tools/integrations-sh.mdx new file mode 100644 index 00000000..6a4c1726 --- /dev/null +++ b/fern/ai-tools/integrations-sh.mdx @@ -0,0 +1,57 @@ +--- +title: "integrations.sh" +description: "Discover Smallest AI's APIs on integrations.sh — a machine-readable catalog of integration surfaces that AI agents can query to find the right endpoint, spec, and credentials." +icon: "globe" +--- + +[integrations.sh](https://integrations.sh) is an open catalog of integration surfaces — REST APIs with their OpenAPI specs, MCP servers, CLIs, and GraphQL endpoints — indexed per domain. Instead of scraping docs pages, an AI agent (or you) can look up exactly how to integrate a service: which endpoints exist, where the machine-readable spec lives, and what credentials each surface accepts. + +## Smallest AI on integrations.sh + +The listing at [integrations.sh/smallest.ai](https://integrations.sh/smallest.ai) catalogs three surfaces, each linked to its OpenAPI spec and marked as Bearer-API-key authenticated: + +| Surface | Base URL | What it covers | +| --- | --- | --- | +| **Atoms API** | `https://api.smallest.ai/atoms/v1` | Voice agents, outbound calls, campaigns, knowledge bases, analytics | +| **TTS API** | `https://api.smallest.ai/waves/v1/tts` | Unified text to speech — every Lightning model via the `model` body parameter, streaming at `/tts/live` | +| **STT API** | `https://api.smallest.ai/waves/v1/stt/` | Unified speech to text — every Pulse model via the `?model=` query parameter, live transcription at `/stt/live` | + +## Setup + + + +### Browse the listing + +Open [integrations.sh/smallest.ai](https://integrations.sh/smallest.ai) to see every surface, its spec, and its auth requirements on one page. + +### Query it from an agent + +The same data is available as JSON from the discovery API: + +```bash +curl https://integrations.sh/api/smallest.ai/discovery +``` + +The response is a typed surface inventory — spec URLs, base URLs, and credential requirements — that an agent can consume directly. + +### Use it in your prompts + +Point your AI coding assistant at the discovery endpoint when building against Smallest AI: + +``` +Fetch https://integrations.sh/api/smallest.ai/discovery, read the TTS API's +OpenAPI spec, and write a Python script that synthesizes speech with the +magnus voice. +``` + + + + + integrations.sh complements [Agent Skills](./agent-skills) and [Context7](./context-7) — skills give your agent curated Smallest AI expertise, Context7 injects the full docs, and integrations.sh provides the machine-readable surface inventory (specs, endpoints, auth) that agents can discover programmatically. + + +## Links + +- Smallest AI listing: [integrations.sh/smallest.ai](https://integrations.sh/smallest.ai) +- Discovery API: [integrations.sh/api/smallest.ai/discovery](https://integrations.sh/api/smallest.ai/discovery) +- About the catalog: [integrations.sh](https://integrations.sh) diff --git a/fern/ai-tools/overview.mdx b/fern/ai-tools/overview.mdx index 6f94e804..71013e4a 100644 --- a/fern/ai-tools/overview.mdx +++ b/fern/ai-tools/overview.mdx @@ -21,4 +21,11 @@ Use Smallest AI more effectively with your AI coding assistant. These tools inje > Install Smallest AI skills into Claude Code, Cursor, or any compatible agent. Your agent gets expert knowledge of the Smallest AI APIs — working code on the first try. + + Discover the Smallest AI APIs as machine-readable surfaces — OpenAPI specs, endpoints, and auth — that your agent can query programmatically. + diff --git a/fern/products/atoms.yml b/fern/products/atoms.yml index d6e0e114..fd4939d2 100644 --- a/fern/products/atoms.yml +++ b/fern/products/atoms.yml @@ -524,6 +524,10 @@ navigation: - page: Agent Skills path: ../ai-tools/agent-skills.mdx icon: fa-solid fa-sparkles + - page: integrations.sh + path: ../ai-tools/integrations-sh.mdx + icon: fa-solid fa-globe + slug: integrations-sh - tab: changelog layout: diff --git a/fern/products/waves/versions/v4.0.0.yml b/fern/products/waves/versions/v4.0.0.yml index 0f42c892..890bfae3 100644 --- a/fern/products/waves/versions/v4.0.0.yml +++ b/fern/products/waves/versions/v4.0.0.yml @@ -594,6 +594,10 @@ navigation: - page: Agent Skills path: ../../../ai-tools/agent-skills.mdx icon: fa-solid fa-sparkles + - page: integrations.sh + path: ../../../ai-tools/integrations-sh.mdx + icon: fa-solid fa-globe + slug: integrations-sh - tab: changelog layout: