Connect an AI agent (MCP)

Use roasOS from Claude, Cursor, and other MCP clients.

roasOS has a hosted MCP server, so AI agents can generate creative and research ads through the same API — with the same safety and billing rules.

Endpoint

https://mcp.roasos.com/mcp

It’s a streamable HTTP MCP server. Authenticate with your API key as a bearer token — the same key you use for REST:

Authorization: Bearer roasos_sk_...

What the agent can do

The server exposes tools for the things you’d expect: list capabilities, quote and generate images/video/audio/lipsync, list and read generations, search Discover, and run the Facebook ad research lifecycle. Read-only tools are marked as such; paid tools are clearly flagged.

Spending is always explicit

The agent can never spend your credits on its own. Every paid tool requires:

1. An Idempotency-Key, and
2. Either quote_only: true (to see the price) or a quote_id (to confirm a price you already saw).

A paid tool call without one of those is rejected before anything runs. So an agent has to quote, show you the price, and get a real quote_id before it can charge you.

Example (Claude Desktop)

Add roasOS as a remote MCP server in your client’s config, pointing at https://mcp.roasos.com/mcp with your API key. Then ask your agent to, for example, “quote a product image of a blue mug” — it will call the quote tool and report the price before doing anything that costs credits.