Connect an AI assistant

Plonki is a remote MCP server at https://plonki.com.au/mcp. Clients that support OAuth open a sign-in page the first time. Clients that don't can send an API key as a Bearer token.

Claude Code

claude mcp add --transport http plonki https://plonki.com.au/mcp

Run /mcp in Claude Code and choose Plonki to sign in. To use a key instead:

claude mcp add --transport http plonki https://plonki.com.au/mcp \
  --header "Authorization: Bearer plk_live_..."

Claude (web and desktop)

1. Open Settings, then Connectors, then Add custom connector.
2. Name it Plonki and paste https://plonki.com.au/mcp.
3. Click Connect and sign in to Plonki.

ChatGPT

1. In Settings, open Apps & Connectors, then Advanced settings, and turn on Developer mode.
2. Create a connector with the URL https://plonki.com.au/mcp and OAuth authentication.
3. Sign in to Plonki when asked, then enable the connector in a chat.

Cursor

~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "plonki": {
      "url": "https://plonki.com.au/mcp"
    }
  }
}

VS Code

.vscode/mcp.json:

{
  "servers": {
    "plonki": {
      "type": "http",
      "url": "https://plonki.com.au/mcp"
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "plonki": {
      "serverUrl": "https://plonki.com.au/mcp"
    }
  }
}

Gemini CLI

~/.gemini/settings.json:

{
  "mcpServers": {
    "plonki": {
      "httpUrl": "https://plonki.com.au/mcp"
    }
  }
}

Any client, with an API key

{
  "mcpServers": {
    "plonki": {
      "url": "https://plonki.com.au/mcp",
      "headers": {
        "Authorization": "Bearer plk_live_..."
      }
    }
  }
}

Permissions

On the consent screen you choose what the assistant can do. You can untick anything.

API keys used as Bearer tokens have every scope. Access tokens last an hour; clients refresh them automatically.

Spending safety

• The server tells assistants never to register without the user's clear go-ahead, and to pass the price the user agreed to as max_price.
• Every order is re-priced live. If the price rose above max_price, the order is refused with price_changed.
• idempotency_key means a retried call returns the same order instead of buying twice.
• Use test mode while you try things out.

For client developers