# Quickstart (/docs/mcp/quickstart)

<Steps>
<Step>

### Add the connector [#add-the-connector]

Paste this URL into your assistant as a custom connector:

```text
https://mcp.swopme.co/mcp
```

<Tabs items={['ChatGPT', 'Claude', 'Grok', 'Claude Code', 'Cursor', 'VS Code']} groupId="mcp-client" persist>
<Tab value="ChatGPT">
1. Open **Settings → Apps & Connectors**. Turn on **Developer mode** if ChatGPT asks for it.
2. Add a custom connector. Name it **Swop**.
3. Paste `https://mcp.swopme.co/mcp` as the server URL and choose **OAuth** for authentication.
4. Connect. Sign in with Swop when a tool first needs your account.
</Tab>
<Tab value="Claude">
1. Open **Settings → Connectors**.
2. Choose **Add custom connector**. Name it **Swop**.
3. Paste `https://mcp.swopme.co/mcp` and connect.
4. Approve the Swop sign-in when Claude prompts you.
</Tab>
<Tab value="Grok">
1. Open [grok.com/connectors](https://grok.com/connectors).
2. Choose **New Connector → Custom**.
3. Paste `https://mcp.swopme.co/mcp` and save.
4. Sign in with Swop when a tool needs your account.
</Tab>
<Tab value="Claude Code">
```bash
claude mcp add --transport http swop https://mcp.swopme.co/mcp
```
Then run `/mcp` inside Claude Code to sign in.
</Tab>
<Tab value="Cursor">
Add this to `~/.cursor/mcp.json`, or to `.cursor/mcp.json` in your project:

```json
{ "mcpServers": { "swop": { "url": "https://mcp.swopme.co/mcp" } } }
```

Or use the **Add to Cursor** button in the Swop web app, under **Developer → MCP & AI assistants**.
</Tab>
<Tab value="VS Code">
Add this to `.vscode/mcp.json` in your workspace:

```json
{ "servers": { "swop": { "type": "http", "url": "https://mcp.swopme.co/mcp" } } }
```

Or from a terminal:

```bash
code --add-mcp '{"name":"swop","type":"http","url":"https://mcp.swopme.co/mcp"}'
```

Start the `swop` server from the MCP server list and sign in when asked.
</Tab>
</Tabs>

<Callout title="Setup cards in the Swop app">
The Swop web app has the same steps as copy-and-paste cards, one per assistant, at **Developer → MCP & AI assistants** ([swopme.app/dashboard/developer?tab=mcp](https://www.swopme.app/dashboard/developer?tab=mcp)). Pick **Selling** or **Everything** there and every card uses that address.
</Callout>

</Step>
<Step>

### Try something public [#try-something-public]

These need no account. Ask your assistant:

- "Look up travis.swop.id."
- "What does travis.swop.id sell?"
- "What prediction markets are live for tonight's games?"

</Step>
<Step>

### Link your Swop account [#link-your-swop-account]

The first time you ask for something personal ("what's my balance?", "sell my ebook for $15"), the assistant opens a **Sign in with Swop** page. Approve it, choosing which permissions to grant. You never type a password into the chat. See [Account linking & caps](/docs/mcp/account-linking-and-caps) for what each permission allows.

</Step>
<Step>

### Turn on AI spending, if you want it [#turn-on-ai-spending-if-you-want-it]

Sending money, paying links, swapping and trading also need AI spending turned on, with caps, in the Swop app under **Settings → AI assistants**, or on the web under **Developer → MCP & AI assistants**. Leave it off and the assistant can still prepare a payment; you finish it in the app.

</Step>
<Step>

### Sell something [#sell-something]

> "Sell a digital zine called *Night Market* for $15. Put it on my page and give me the link."

The assistant creates the product, features it on your SmartSite and returns one link. People who open it see a product page; [AI agents get a USDC payment challenge](/docs/agent-payments) they can pay on their own.

</Step>
<Step>

### See and remove connections [#see-and-remove-connections]

Every assistant you have signed in with is listed in the Swop web app under **Developer → MCP & AI assistants**. Each one shows when it connected, what it may do and when it was last used. **Disconnect** removes its access straight away.

</Step>
</Steps>

## Prefer a connection that can't move money? [#prefer-a-connection-that-cant-move-money]

Use `https://mcp.swopme.co/mcp/commerce` instead. It has selling, SmartSite and lookup tools only; sends, payments, swaps, trading and agent control stay in the Swop app. The same sign-in works on both. See [Endpoints](/docs/mcp/endpoints).

## Selling on your own website? [#selling-on-your-own-website]

A connected assistant can do most of the setup for you. See [Set up your website from chat](/docs/mcp/set-up-your-site).
