Documentation

Get started

Cotlet gives your agent and your scripts an API for apps that never built one. One key works across every app on your account, over MCP or REST.

Choose how you connect

Quickstart

  1. 1

    Request access. Pick your apps on the sign-up page. We review each request and email you your API key.

  2. 2

    Connect your app account. Sign in to the app once on the connect page. We keep the session, never your password.

  3. 3

    Make your first call. Add the MCP server to your agent, or call the REST endpoint from a script.

cURL
curl -X POST https://cotlet.dev/api/v1/skool/list_members \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group": "yourgroup"}'
Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"
Python
from cotlet import Cotlet

client = Cotlet()  # reads COTLET_API_KEY
members = client.call("skool", "list_members", {"group": "yourgroup"})
Node.js
import { Cotlet } from 'cotlet';

const cotlet = new Cotlet(); // reads COTLET_API_KEY
const members = await cotlet.call('skool', 'list_members', { group: 'yourgroup' });

Base URLs

Cotlet base URLs
InterfaceURLUse it for
REST APIhttps://cotlet.dev/api/v1Scripts, backends, n8n HTTP nodes
MCP serverhttps://cotlet.dev/mcp/v1AI agents and MCP clients

Authentication

Every call carries your API key as a bearer token. One key covers every app your account has access to; access is granted per app.

Header 

Authorization: Bearer COTLET_API_KEY
  • Listing apps, endpoints and schemas needs no key.
  • Keep the key in an environment variable such as COTLET_API_KEY, never in code you commit.
  • Rotate or revoke keys in your dashboard at any time.

Key concepts

Key concepts of the Cotlet API
ConceptWhat it means
AppA product without a usable API, such as Skool or Booksy. Each has a slug: skool, booksy.
EndpointOne action in an app: list_members, create_post. The same action is an MCP tool named skool_list_members.
Accessread endpoints only read data; write endpoints change something in the app.
ConfirmEndpoints that reach other people (posts, messages, emails) wait for your OK by default. You can switch that off per endpoint.
Connected accountYour own login to the app, kept as an encrypted session. Calls run as you, with your permissions.
CreditsEach successful call uses credits; failed calls are free. See pricing.

For AI agents

Agents can explore Cotlet without an account. Everything below answers without a key.

  • Every app and endpoint as JSON: GET https://cotlet.dev/api/v1/apps.
  • Every MCP tool: tools/list on the MCP server.
  • A summary of the site for agents: /llms.txt.
  • Every page as Markdown: send Accept: text/markdown, or add .md to the URL.

App missing? Ask for it without an account (10 requests an hour):

Request an app 

curl -X POST https://cotlet.dev/api/v1/integration-requests \
  -H "Content-Type: application/json" \
  -d '{"app": "Notion", "use_case": "what you want done"}'