Telep Muse platform

Catalog website + API gateway for Telep IO’s Muse connectors.

• Catalog: muse.telep.io (this Next.js app)
• Gateway: api.muse.telep.io (same deploy; Host contains api.)
• Contact: jon@telep.io

Telep IO builds independent connectors that work with Muse, Meta’s personal assistant. Telep is not affiliated with, endorsed by, or a partner of Meta. Users discover and connect products through Meta’s own review process.

Architecture

One Next.js App Router app, with connector modules kept separate so the path to ~100 connectors stays obvious:

app/                    Catalog pages + gateway route handlers (Vercel)
packages/registry/      Typed connector catalog (source of truth)
packages/platform/      Auth, CORS, errors, rate-limit stub, OpenAPI merge, Stripe helpers, MCP HTTP
connectors/paper-send/  Callable MCP + REST stub (Express app is services/paper-send)
connectors/sumvid/      YouTube summarize stub (REST + MCP + OpenAPI)
connectors/shipsignal/  Package tracking stub (REST + MCP + OpenAPI)
connectors/*-send/      Sign/fax/call/ink/domain MCP + REST stubs
services/*-send/        Express fulfillment apps (not workspaces; not in the Vercel build)
lib/gateway.ts          Dispatch: slug → connector module
middleware.ts           api.* host rewrites `/` → `/v1`

services/ holds the Express fulfillment apps formerly published as standalone repos (call-send, domain-send, fax-send, ink-send, paper-send, sign-send). Each keeps its own package.json and lockfile. They are not npm workspaces and the Next.js app does not import them. PaperSend is the furthest along and is the one that ships a Dockerfile and compose files. Moving it under services/paper-send changes the code location only; where it is deployed does not change. See services/README.md.

The legacy Vite frontend Telep-IO/api-gateway-app is not this gateway.

Production is two hostnames, one Vercel project. Preview and local are one host: / is the catalog; /v1, /mcp, and /health are the gateway.

Local run

Requires Node 20+.

cp .env.example .env.local
npm install
npm run dev

Open http://localhost:3000. Gateway paths work on the sa