MCP and API keys

Connect Claude or ChatGPT

Add the Koast MCP server to your assistant, sign in, and pick what it's allowed to do.

The server address is:

https://mcp.koast.ai/mcp

That's the only value you need for a client that supports remote MCP servers and OAuth. Everything else is discovered.

Add it to your assistant

  1. Open your assistant's connector settings

    In Claude, add a custom connector. In ChatGPT, add a connector in settings. Other clients call it an MCP server or a remote server.

  2. Paste the server address

    Use https://mcp.koast.ai/mcp. Don't add a key. The client registers itself with Koast automatically.

  3. Sign in to Koast

    Your browser opens a Koast sign in screen. Sign in with the account you already use.

  4. Choose what it can do

    The approval screen lists What it will be able to do. Grant the least the client needs. Publish is Off unless you turn it on and marked Spends money.

  5. Set a publish limit, if you granted Publish

    Publish limit is the most this client may ever put live, in total. Publishing is refused without one.

  6. Pick a brand

    Back in the assistant, ask it to list your brands and choose one. Nothing brand specific runs until a brand is active.

A good first question: "Which ad sets are over target CPA this week?"

If your client can't do OAuth

Some clients only accept a static token. For those, create an API key in Koast and paste it as a bearer token. See Create and manage API keys.

Check or remove a connection

Every app you've connected by signing in appears in Koast under API Keys, in the Authorized apps list, with its Access, when it was Authorized and when it was Last used. Revoking one takes effect on its next request.

The command line

The same tools are available as a koast command, generated from the same manifest, so the CLI can never offer more than your assistant can.

The CLI isn't self serve yet

@koast.ai/cli isn't on npm today. Ask Koast support for a build if you want it.

On this page