Agent-first API · connect
Connect your agent
One copy-paste per client type. Everything on this page runs without a key or a signup — the mount and the API meter guests per IP, and a free email-only key at /signup is only for keeping usage on one account.
Claude & ChatGPT apps — add the connector
Claude Desktop, claude.ai, ChatGPT (desktop and web).
Desktop chat apps have no shell and a restricted fetch tool: they can read our docs but cannot call the API. The MCP connector is the door that works — add this URL once and the eight searches are available in every chat.
https://createwith.dev/api/v1/mcpClaude (desktop or claude.ai)
- Settings → Connectors → Add custom connector.
- Paste the URL above and save. It is keyless, so no sign-in screen appears.
- If the tools don't show up in a chat: open the tools menu under the message box and toggle the connector on. A chat begun before the install may need a reload.
ChatGPT (desktop or web)
- Settings → Apps & Connectors → enable Developer mode (the menu name moves between releases; custom connectors live behind it).
- Add a custom connector and paste the URL above.
- Enable it in the conversation's tools before asking.
Claude Code — one command
Claude Code (CLI and IDE).
claude mcp add --transport http createwith https://createwith.dev/api/v1/mcpThe nine tools load on the next session. With a key, append --header "Authorization: Bearer tw_live_…" to keep usage on your account. The skill file (below) is the alternative — either way the menu is loaded before anyone asks.
Cursor & IDEs — mcp.json
Cursor, Windsurf, and any client that reads an mcpServers config.
Cursor: save as .cursor/mcp.json in the project, or ~/.cursor/mcp.json for every project. Windsurf and most MCP clients accept the same shape.
{
"mcpServers": {
"createwith": {
"url": "https://createwith.dev/api/v1/mcp"
}
}
}VS Code reads a servers variant from .vscode/mcp.json:
{
"servers": {
"createwith": {
"type": "http",
"url": "https://createwith.dev/api/v1/mcp"
}
}
}Codex — install the skill
Codex CLI.
mkdir -p ~/.agents/skills/createwith && curl -fsSL https://createwith.dev/skill.md -o ~/.agents/skills/createwith/SKILL.mdThe contract as a skill file, at the path Codex scans for skills. Claude Code loads the same file from ~/.claude/skills/createwith/SKILL.md.
skills CLI
Claude Code or Codex, via the skills installer.
npx skills add https://createwith.devEither host, via /.well-known/skills/index.json.
No MCP client — paste a prompt
A CLI agent with a shell but no web tools.
Handed a bare URL, a shell-only agent makes zero requests — it has no browser and says so. Paste this into the chat instead; the curl is the web tool.
CreateWith is a Twitch creator-discovery API for brand campaigns. Fetch the contract with: curl -s https://createwith.dev/llms.txt — it carries a menu of eight named searches. A first worked call: curl -s "https://createwith.dev/api/v1/creators/search?limit=3". Reads and searches need no key.Raw HTTP — curl
Scripts, cron jobs, anything that speaks HTTP.
The REST index is at /api/v1 and a first search needs nothing:
curl -s "https://createwith.dev/api/v1/creators/search?limit=3"The mount speaks JSON-RPC over plain POST too. Both Accept values are required — without them the mount answers 406:
curl -s https://createwith.dev/api/v1/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0.1"}}}'The short contract is at /llms.txt, the long reference at /llms-full.txt, and the machine spec at /openapi.json.