MCP server

Connect your AI agent to Magic Booklet

Magic Booklet runs a remote MCP server. Connect Claude, Codex or Cursor today, and ChatGPT soon. A connected agent can make images and videos with your credits, follow each run to the end and publish the ones you choose.

Server URL

https://magicbooklet.com/api/mcp

What it can do

What a connected agent can do

Create images and videos with your credits

Your agent picks from the models the site offers, prices a run and starts it. What it makes lands in your library like anything you create yourself.

Check progress

It follows a run until the image or video is ready, hands you its link, and can look through what you have already made.

Publish a creation as a post

When you ask, it posts a finished creation to your profile and Explore, under your name and with the rules every post follows.

Credits

Every charge is quoted first

Pricing a run is free, and your agent gets the price before it creates anything. It has to send that price back when it starts the run, and the run is never charged more: if the price has changed, nothing is charged and your agent asks you again.

A run that fails gives its credits back by itself. The one charge without a price step is prompt enhancement, a fixed 2 credits a call. Agents cannot buy credits; top up on the site.

Your account

Your account stays in control

You approve each app

An app connects only after you allow it on a Magic Booklet page that names it and lists what it may do. A guest session is asked to sign in first.

Disconnect any time

Connected apps on your profile lists every app you allowed. Disconnect one there and its next call is refused; signing out everywhere ends them all.

A one-hour sign-in

An app holds a sign-in that lasts an hour and renews only while it stays connected. It never sees your password, and your account’s limits apply to it as they do to you.

Set up

Connect your client

Each client signs in with its own Magic Booklet client ID, and you approve it once in your browser.

Claude.ai and Claude Desktop

Available

In Claude, open Customize → Connectors and choose Add custom connector.
2
Name it Magic Booklet and enter the server URL.
```
https://magicbooklet.com/api/mcp
```
3
Open Advanced settings (or, if the dialog asks how Claude identifies itself, choose Use your own OAuth client) and enter this client ID. Leave the secret blank.
```
cf5743f9-c83c-4f6c-9afb-0803d5aee698
```
Choose Add, then Connect. Magic Booklet opens in your browser and asks you to allow Claude.

A connector added on claude.ai also works in Claude Desktop and the Claude mobile apps.

Claude Code

Available

Add the server from any terminal. It is added for your user, so every project you open in Claude Code has it.

claude mcp add --transport http --scope user --client-id 0b968a27-4f37-4972-8d7a-f3c67b365a33 --callback-port 8976 magicbooklet https://magicbooklet.com/api/mcp

In Claude Code, run /mcp, pick magicbooklet and choose Authenticate. Your browser opens on Magic Booklet; once you allow it, Claude Code shows the server as connected.

Or install the plugin

The Magic Booklet plugin adds the same server and two skills: one that takes a UGC ad from brief to post, and one that publishes a creation. Sign in with /mcp as above. Use the command or the plugin, not both: each would add its own magicbooklet server and ask you to sign in again.

Add the marketplace:

claude plugin marketplace add 112kratoss/ugc-copy

Install the plugin:

claude plugin install magicbooklet@magicbooklet

Signing in listens on port 8976, so keep that port free while you sign in.

ChatGPT

Coming soon

Magic Booklet is being registered as an app with ChatGPT. Its setup appears here as soon as it can sign in; until then, connect from one of the clients marked available.

Codex

Available

Add the server with its client ID.

codex mcp add magicbooklet --url https://magicbooklet.com/api/mcp --oauth-client-id 6508034a-cdb9-4f23-9263-7bf332096acb

Codex signs in on a random port unless told otherwise, so pin it: in ~/.codex/config.toml the server’s entry should read as below, callback_port included.

[mcp_servers.magicbooklet]
url = "https://magicbooklet.com/api/mcp"

[mcp_servers.magicbooklet.oauth]
client_id = "6508034a-cdb9-4f23-9263-7bf332096acb"
callback_port = 8977

3
Sign in, and allow Codex on Magic Booklet.
```
codex mcp login magicbooklet
```

Cursor

Available

Add the server to ~/.cursor/mcp.json for every project, or to .cursor/mcp.json in one project.

{
  "mcpServers": {
    "magicbooklet": {
      "url": "https://magicbooklet.com/api/mcp",
      "auth": {
        "CLIENT_ID": "cd3b041d-a942-4917-b37f-735744ca4026"
      }
    }
  }
}

Cursor lists magicbooklet in its MCP settings. Sign in there when it asks, and allow Cursor on Magic Booklet.

Questions

Common questions

Does connecting an agent cost anything?

Connecting is free, and so is pricing a run. Credits are spent only when your agent starts a run, at the price it showed you, or enhances a prompt, a fixed 2 credits a call.

Can an agent spend more than it quoted?

No. A run is never charged above the price your agent confirmed: if the price changes before the run starts, nothing is charged and the agent has to quote again. Agents cannot buy credits.

How do I disconnect an app?

Open Connected apps on your profile and disconnect it, and its next call is refused. Signing out everywhere ends every app’s access at once.

Which accounts can connect?

Any Magic Booklet account. A guest session is asked to sign in or create an account first, because the agent works with that account’s credits and posts.

For developers

How the server works

Streamable HTTP at https://magicbooklet.com/api/mcp, stateless, answering in JSON.
OAuth 2.1 with PKCE through Magic Booklet’s sign-in, with one registered client per app and no dynamic registration. The protected-resource metadata is at https://magicbooklet.com/.well-known/oauth-protected-resource/api/mcp.
A tool answers in text and structured content; a refusal carries a code such as COST_CHANGED or INSUFFICIENT_CREDITS with what to do next.