# CreateWith — connecting an agent

> Every artifact a client needs to reach CreateWith — Twitch creator discovery
> for brands — in one file: the connector URL, the per-client configs, and the
> call that confirms a connection.

One call that returns creators, with no key and no signup:

```
curl "https://createwith.dev/api/v1/creators/search?limit=3"
```

No key is needed to start — a key (free, email-only) keeps usage on one account.
The contract itself, at `/llms.txt`, is the other half: the eight named
searches, the response envelope and the limits of the data.

## The connector URL

The connector URL is what the Claude and ChatGPT apps take as a custom connector — it is keyless, so no sign-in screen is part of the flow.

```
https://createwith.dev/api/v1/mcp
```

The mount behind it is streamable-http (stateless, POST only), with 9 tools.
It is the strongest door measured here, and for desktop chat apps the only one
that executes: their fetch tools read a document like this one but cannot call a
parameterised API URL. Raw HTTP callers send
`Accept: application/json, text/event-stream` — the transport answers 406
without it, and MCP client libraries set it themselves.

## Claude Code

One command registers the mount in Claude Code; the nine tools load on the next session:

```
claude mcp add --transport http createwith https://createwith.dev/api/v1/mcp
```

## Cursor, Windsurf and other mcpServers clients

The same mount as a config file — `.cursor/mcp.json` inside one project, or
`~/.cursor/mcp.json` for every project. Windsurf and most MCP clients read this
same shape; VS Code takes a `servers` variant, which is on
[/connect](https://createwith.dev/connect).

```json
{
  "mcpServers": {
    "createwith": {
      "url": "https://createwith.dev/api/v1/mcp"
    }
  }
}
```

## Codex

The same contract as a skill file, written where Codex scans for skills:

```
mkdir -p ~/.agents/skills/createwith && curl -fsSL https://createwith.dev/skill.md -o ~/.agents/skills/createwith/SKILL.md
```

## The skills CLI

Either host — Claude Code or Codex — installs that skill from
`/.well-known/skills/index.json`:

```
npx skills add https://createwith.dev
```

## An agent with a shell and no MCP client

A shell-only agent reaches the same data over plain HTTP, and `/llms.txt` is the
contract it reads: the named searches, the call each one maps to, and how to read
what comes back. The curl above is a first worked call. A bare URL on its own
leaves such an agent making zero requests — it has no browser, and says so.

## Verifying a connection

The MCP handshake as one keyless call:

```
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"}}}'
```

It answers with `serverInfo` and the same menu as `instructions`. `initialize`,
`tools/list` and `ping` are keyless and meter nothing.

Over REST, a successful body is `{ data, meta }`, and `meta.billing.lane` reads
`guest` on a keyless call — nothing billed, and the free-call counter untouched.

## What a person can ask once connected

- "Find rising English-language VALORANT streamers under 10k followers" — Rising in a game
- "Show me the small Twitch channels blowing up this week" — Trending right now
- "Find creators whose live audience is unusually big for their follower count" — Undervalued engagement
- "Tell me everything you know about the streamer quiggy_" — Creator lookup
- "Find Twitch streamers who are also working musicians" — Off-platform interest
- "Find German-speaking streamers for a campaign running in Germany" — Market-targeted
- "Build a brand-safe shortlist of Fortnite creators between 1k and 50k followers" — Brand-safe shortlist
- "What's happening on Twitch right now?" — What's live now

The full menu — each ask with the blanks it needs and the call that answers it —
is [/llms.txt](https://createwith.dev/llms.txt).

## More

- [/llms.txt](https://createwith.dev/llms.txt) — the short contract: the menu, the facts, the envelope.
- [/llms-full.txt](https://createwith.dev/llms-full.txt) — every parameter and every response field.
- [/api/v1](https://createwith.dev/api/v1) — the live JSON index: the same menu and facts as data.
- [/skill.md](https://createwith.dev/skill.md) — the same contract as an installable Agent Skill.
- [/openapi.json](https://createwith.dev/openapi.json) — OpenAPI 3.1 schema.
- [/connect](https://createwith.dev/connect) — these same steps as a page for a person.