Reader Radius for AI agents

Connect your AI agent to Reader Radius

An AI agent is an assistant such as Claude, ChatGPT or Cursor that can use tools for you. Connected to Reader Radius, it can post and schedule across 15 social platforms, answer comments and DMs, report on results and run ads on 8 ad networks, Amazon Ads included. You give the agent one address, sign in to Reader Radius and choose which pen names it can use. There's no server to install or run on your computer.

Keep yourself in the loop: ask your agent to show you each post or ad before it schedules or creates anything.

Which AI agents work with Reader Radius?

These agents have their own setup steps below. Any other app that supports MCP connects with the same address.

AgentMade byHow it connectsAuthenticationGuide
Claude (web and desktop)AnthropicAdd Reader Radius in Claude's settings with one addressSign in when askedSetup steps
CoworkAnthropicThe same Claude setting, plus the optional skills pluginSign in when askedSetup steps
Claude CodeAnthropicOne line in the terminal (steps below), plus the optional skills pluginSign in when askedSetup steps
ChatGPTOpenAIAdd Reader Radius in ChatGPT with its own addressSign in when askedSetup steps
CodexOpenAIOne line in the terminal, or its settings file (steps below)Sign in when askedSetup steps
CursorAnysphereCursor's settings (steps below)Sign in when askedSetup steps
Gemini CLIGoogleOne line in the terminal (steps below)Sign in when askedSetup steps
Other AI appsThe Reader Radius address in the app's settingsSign in when asked, or use a key if the app can't sign inSetup steps
Make, Zapier, n8n and your own scriptsOur developer tools (steps below)A key from your accountSetup steps

How do AI agents connect to Reader Radius?

There are three ways in. Most people only need the first: connecting your assistant gives it everything your plan includes. The skills plugin and the key for scripts are optional.

SurfaceUsed byAuthenticationWhat it gives you
Connect your assistanthttps://readerradius.com/api/mcpClaude, Cowork, Claude Code, Codex, Cursor, Gemini CLI and other AI apps. ChatGPT uses https://readerradius.com/api/mcp/chatgpt.Sign in to Reader Radius, choose the pen names, approveEverything your plan includes
Skills pluginClaude Code, Cowork and CodexNone of its own: it uses your Reader Radius connectionReady-made skills and shortcuts for posts and campaigns in Claude Code and Cowork. It doesn't connect your account.
Key for scripts and appsMake, Zapier, n8n, your own scripts and apps that can't sign inA key you create on Settings → Integrations (the Connect your AI page on the MCP plan), limited to the pen names you chooseEverything your plan includes, for scripts and apps that can't sign in

An app that asks for a client ID and secret can still use one. Create the pair under Advanced on Settings → Integrations (the Connect your AI page on the MCP plan).

Connect any AI agent in three steps

  1. 1

    Pick the address your agent uses

    Most assistants use the main address. ChatGPT has its own. Scripts and apps that can't sign in use a key from your account instead.

    # Claude, Cowork, Claude Code, Codex, Cursor, Gemini CLI and other MCP apps
    https://readerradius.com/api/mcp
    
    # ChatGPT
    https://readerradius.com/api/mcp/chatgpt
    
    # Scripts and apps that can't sign in: send your API key
    Authorization: Bearer aa_sk_...
  2. 2

    Sign in, or set your API key

    When you add the address, your agent opens a Reader Radius sign-in page. Sign in, choose the pen names it can use and approve. There's no client ID or secret to paste. Using an API key instead? Check it works with one request:

    Terminal
    curl -H "Authorization: Bearer aa_sk_..." \
      https://readerradius.com/api/v1/accounts
  3. 3

    Ask your agent

    Start a new chat and ask in plain words. Your agent picks the right Reader Radius tool.

    You: List my connected accounts, then draft an Instagram post about my new release for Friday at 9am. Show me the draft before you schedule it.
    Agent: Your pen name has 3 connected accounts: Instagram, Facebook and TikTok. Here's the Instagram draft for Friday at 9am: "Book two is out Friday. If you loved the first one, the ending of this one is for you. Link in bio." Want me to schedule it as written, or change anything first?

    An example of the kind of reply you'll see. Your accounts and draft will differ.

What can an AI agent do with Reader Radius?

Post and schedule

Posts, carousels, reels and shorts across 15 social platforms, published now, at a set time or into a queue slot.

Run ads

Create, report on and pause ads on 8 ad networks. Amazon campaigns your agent creates always start paused until you start them.

Answer readers

Read and reply to comments and DMs, and set up comment-to-DM rules that send a free chapter.

Report results

Reach and engagement by platform, plus Amazon spend, sales and ACOS compared with royalties.

Plan campaigns

The Reader Radius publisher playbook and ready-made prompts help your agent plan a launch or a week of posts.

Work across pen names

Each pen name keeps its own accounts and calendar. Your agent only sees the pen names you approved.

Example prompts

Paste any of these into Claude or ChatGPT, or say it your own way.

  • “What should I do next with my book marketing?”

  • “Post this image to Instagram and Facebook tomorrow at 9am with a caption about my new release.”

  • “How did my posts do last week? Show reach and engagement by platform.”

  • “Reply to that comment and thank them for reading.”

  • “When someone comments READ, DM them my free chapter.”

  • “Are my Amazon ads profitable once page reads are counted?”

  • “Create a $10 a day Sponsored Products campaign for my paperback with automatic targeting, and leave it paused for me to check.”

  • “Pause the ads that aren't getting clicks.”

Make your own pages and dashboards

Your assistant can turn your Reader Radius accounts into the pages you actually want to look at: a calendar of your posts, a report on what's growing, the messages waiting for you, a summary of your ads. Paste a request below into Claude, Cowork or another assistant that makes pages, then ask for changes in plain words.

  1. A calendar of your month

    What you get: Every post for the month on one calendar, with a picture of each, what's coming up next and your launch dates marked.

    Request: a calendar of your month

    Make me a calendar of this month's posts, with a small picture of each one, what's coming up next and my launch dates. Put anything without a date in a separate list. Don't schedule, move or delete anything.

    1. Connect Reader Radius to Claude or ChatGPT, then start a new chat.
    2. Paste the request. If you write under more than one pen name, say which one.
    3. Ask for changes in plain words, like a week view, one color per book or a version for your phone.
    • Just changed something in Reader Radius? Ask it to check again, because the calendar can be a few minutes behind.
    • A busy month can come back cut short. Ask it to tell you if anything was left out.
    • Want it to stay current? See the page that updates itself, below.
  2. A report on what's growing

    What you get: How your followers grew on each platform, which posts did best, the best times to post, and whether your Amazon ads paid for themselves.

    Request: a report on what's growing

    Make me a report for the last 30 days compared with the 30 before: how my followers grew on each platform, my best posts, the best days and times to post, and whether my Amazon ads earned back what they cost. Put the dates next to every number, then tell me one thing to change next week.

    1. Paste the request into a new chat.
    2. The first time, check a number or two against your Reader Radius dashboard.
    3. Ask for the version you'll reuse, like a short one for Monday mornings.
    • For more than a year of history, ask for one year at a time.
    • If it says analytics isn't switched on for your account yet, email [email protected] and we'll help.
    • The Amazon number counts the sales and Kindle Unlimited page reads Amazon credits to your ads, not all of your royalties.
  3. An inbox that waits for your OK

    What you get: Comments, messages and reviews from all your accounts in one list, with what needs an answer first, a mood tag on each and a reply drafted in your voice.

    Request: an inbox that waits for your ok

    Show me the comments, messages and reviews from all my accounts, with the ones that need an answer first. Mark each one happy, a question or unhappy, and draft a reply in my voice. Don't send anything. Show me the drafts, and send only the ones I approve here.

    1. Paste the request and read the drafts.
    2. Approve in the chat, for example: send 1 and 3, make 2 shorter.
    3. It sends only the replies you approved.
    • Replies go out the moment it sends them, so keep "don't send anything" in your request.
    • Ask for a button that copies your choices back into the chat in one go.
    • Tell it never to promise refunds, discounts or dates you haven't confirmed.
  4. A page that updates itself

    What you get: Any of these pages saved so it shows fresh numbers from Reader Radius every time you open it. Claude calls this a live artifact.

    Request: a page that updates itself

    Save this as a page that gets fresh numbers from Reader Radius every time I open it, with a refresh button. Show when each part last updated, and if a part can't load, say it needs Reader Radius connected. Keep it read-only: no buttons that post, reply or change ads.

    1. In Claude's settings on claude.ai, add Reader Radius under Connectors. The Claude setup steps show how.
    2. Make the page in a Claude chat, Cowork or Claude Code, then paste the request.
    3. The first time the page asks to use Reader Radius, approve it. After that, open it any time.

    Claude setup steps

    • It needs a paid Claude plan: Pro, Max, Team or Enterprise. Use an up-to-date version of Claude Code.
    • Add Reader Radius in Claude's own settings on claude.ai, under Connectors. If you only added it inside Claude Code by typing a command, it can help make the page, but the saved page can't fetch fresh numbers.
    • The page updates when you open it, and when you press its refresh button. It doesn't run in the background or send alerts.
    • Sharing the page doesn't share your data: each person sees it through their own Reader Radius account, after they approve. On Team and Enterprise plans you can share it inside your organization. Anyone who opens a public link without signing in to Claude, or from outside your organization, sees the page without its live numbers, so on Pro and Max the live numbers are just for you.
    • On Team and Enterprise plans, an Owner can turn this on or off in Claude's admin settings, under Enable artifact connectors.
  5. A small page on your own computer

    What you get: A simple page on your own computer, made for you by Claude Code, that shows your Reader Radius numbers. Good for a second screen, a spreadsheet or a daily summary.

    Request: a small page on your own computer

    Make me a small page on my computer that shows this week's scheduled posts and my best times to post from Reader Radius. Use my Reader Radius key from my computer's settings, never save it in a file or show it on the page, and tell me how to refresh the page.

    1. On the Connect your AI page, create a key and limit it to the pen names this page needs.
    2. Ask Claude Code to keep the key in your computer's settings rather than in a file.
    3. Paste the request into Claude Code, then open the page it makes. Run it again whenever you want fresh numbers.
    • Your account has one key, shared by every app that uses it. Changing its pen names changes them everywhere.
    • Keep the key out of anything you share, including the page itself.
    • Developers can find every request this page can make at readerradius.com/docs/api.
  6. All your ads on one page

    What you get: What you spent and what you got on every ad network, how close you are to your monthly budget, your best ads, whether your Amazon ads paid for themselves and the changes it suggests.

    Request: all your ads on one page

    Make me one page for all my ads this month: what I spent and what I got on each network, how I'm tracking against my $300 monthly budget, my three best ads, and whether my Amazon ads earned back what they cost. Then list the changes you'd make, and don't change anything until I say so.

    1. Change the budget in the request to yours, then paste it.
    2. Read the suggestions. Each one names the campaign and the reason.
    3. Say which ones to make. It can pause or start a campaign for you. For a budget or ad change, ask it to tell you exactly what it will do first.
    • Networks count results differently: some count clicks, some count sales. Ask it to say which, next to every number.
    • Its suggestions are only suggestions. Nothing changes until you approve it.
    • Amounts in different currencies aren't added together, and Amazon totals are in US dollars.
    • A long list of campaigns can come back cut short. Ask it to tell you if anything was left out.
  7. An ads plan that starts with your book

    What you get: Your assistant asks about your book, where it sells, what it's for and what you want to spend, then makes an ads plan you read before anything launches. It asks the same questions as the ads wizard in the Reader Radius dashboard.

    Request: an ads plan that starts with your book

    Help me plan ads for my book. Ask me one question at a time: is it fiction or non-fiction, the genre, what the book is for if it's non-fiction, where it sits in my series, where it's sold, and how much I'm comfortable spending a day to start. Then make a plan with the Reader Radius ads playbook, check my book's reviews if you can, write the ad hooks yourself, and explain the plan in plain words. Don't create any ads. Save the plan when I say I like it.

    1. Paste the request and answer each question. If you're not sure, say so and it will suggest a starting point.
    2. Read the plan: which networks, the daily budget, who it reaches and the tests it suggests.
    3. Ask for changes, or save it. Saving the plan doesn't create or start any ads.
    • The plan starts from Reader Radius's standard target: ad spend of about 35% of the sales the ads bring in (authors call this ACOS). Ask it what that means for your book.
    • It can suggest search keywords if you've connected Google Ads, and look at similar authors' ads in Meta's or LinkedIn's public ad library (Meta's archive covers ads shown in the EU and UK).
    • Checking reviews needs the book's ASIN and works best once it has 20 or more reviews.
    • Amazon campaigns it creates later start paused. On other networks, ask it to create ads paused if you want to check them first.
    • The audiences and hooks it writes stay in your chat, so ask it to save them somewhere you'll find them.
    • If you've added the Reader Radius plugin to Claude, it asks these questions for you.

Setup steps by agent

Connect your social and ad accounts in Reader Radius first: your agent can only use accounts that are already connected.

Claude and Cowork

In Claude or Cowork, adding Reader Radius as a custom connector needs nothing installed. You paste one address, sign in to Reader Radius, choose the pen names Claude can use, and approve. Then Claude can read your accounts and schedule posts on your behalf.

This video shows the older setup with a client ID and secret. You can skip those steps now. About 3 minutes.

1. Copy your Reader Radius address

https://readerradius.com/api/mcp

It's the same for every Reader Radius account and also shows on Settings → Integrations. Connect your social accounts there first: Claude can only post to accounts already connected.

2. Add the custom connector in Claude

  1. In Claude or Cowork, open Settings → Connectors → Add custom connector.
  2. Name it Reader Radius and paste the address into “Remote MCP server URL”. Leave Advanced settings empty.
  3. Click Add, then Connect.
  4. Sign in to Reader Radius, choose the pen names Claude can use, and click Approve.

Already connected with a Client ID and Client Secret? That connection keeps working. To add one that way, use the Advanced section on Settings → Integrations.

3. Install the plugin for skills

The connector you just added gives Claude the tools. This step adds the skills (pen-name switching, Trial Reels, Threads chains, YouTube Shorts, Reddit, campaign builder) and shortcuts for posts and campaigns. One marketplace, two paths to install. Pick whichever Claude you're using.

In Cowork

  1. Settings → Plugins → click the + next to Personal.
  2. Add a marketplace from URL and paste:
https://github.com/chellehoniker/claude-code-author-automations
  1. Click Sync, then click the + next to Reader Radius to install. Older clients may show author-automations-social; the internal identifier is unchanged.
  2. Recommended: three-dot menu on the marketplace → Sync automatically: ON so future skill updates flow without re-adding.

In Claude Code (CLI)

/plugin marketplace add https://github.com/chellehoniker/claude-code-author-automations
/plugin install author-automations-social@author-automations

4. Try it

Open a new chat in Cowork and ask:

List my connected social accounts.

Claude should show the accounts for the pen names you approved. From there, try “write me an Instagram post about my new book and schedule it for Friday at 9am.”

Claude Code

Claude Code is Claude in your terminal. One command connects it to Reader Radius. The skills plugin is optional: it teaches Claude how to write platform-specific captions, run multi-day campaigns, switch pen names and pick the right post type, but it doesn't connect your account by itself.

1. Add the MCP connection

Run this in your terminal. There's no client ID or secret to paste: Claude Code registers itself and you approve it in your browser.

Terminal
claude mcp add --transport http --scope user reader-radius https://readerradius.com/api/mcp

2. Sign in

In Claude Code, run /mcp, select reader-radius and choose Authenticate. Sign in to Reader Radius, choose the pen names and approve. It then shows under connected apps on Settings → Integrations. Already connected? Keep the existing connection; don't add another server.

3. Optional: add the skills

In any Claude Code session
/plugin marketplace add https://github.com/chellehoniker/claude-code-author-automations
/plugin install author-automations-social@author-automations

These commands install skills only. Keep the plugin ID shown above even though its display name is Reader Radius.

4. Try it

Start a new session and ask Claude to list your pen names. With the skills installed, Claude also knows the publisher's routines. Try:

Single post

Post a Trial Reel about my new cover on Friday at 6pm.

Multi-day campaign

Plan a 14-day launch campaign for Curses and Currents on Instagram, Threads and TikTok.

Or describe what you want in plain words. The skills tell Claude when to switch pen names, where to post a vertical video, YouTube Shorts or Instagram Reels, and when to use a Threads chain.

ChatGPT

Two separate parts: the MCP server gives ChatGPT the Reader Radius tools. The optional skills plugin adds guided skills. Installing the skills alone does not connect your account. Connect your social accounts in Reader Radius before you ask ChatGPT to post.

1. Add Reader Radius as a custom MCP server

  1. In ChatGPT, open Plugins, click + and choose Add custom MCP server.
  2. Name it Reader Radius and paste the URL above. It ends in /chatgpt, which is ChatGPT's own address.
  3. Leave authentication on OAuth. Don't enter a client ID or secret.
  4. Click Create.

2. Sign in and approve

ChatGPT sends you to Reader Radius. Sign in, choose the pen names ChatGPT can use and approve. You're sent back to ChatGPT. Manage the connection later on Settings → Integrations.

Some ChatGPT plans and workspaces turn custom MCP servers off. If you don't see Add custom MCP server, ask your workspace admin, or use a personal account.

3. Check the connection without posting

Start a new chat with Reader Radius turned on and ask: “Show the pen names I can access. Do not create, schedule, or publish anything.” Only the pen names you approved should appear.

4. Optional: install the skills plugin

In the desktop app's plugin settings, add a marketplace from a URL if that option is available. Paste the repository URL below, sync it and install Reader Radius. Older clients may display author-automations-social; that internal name is intentional.

Terminal alternative for Codex CLI

Run these in your terminal, not in a chat message. Then restart the desktop app and start a new chat.

The skills are optional. ChatGPT can use every Reader Radius tool through the MCP server without them.

If something goes wrong
  • Sign-in fails: check the URL ends in /api/mcp/chatgpt with no extra spaces, and that authentication is OAuth with the client ID and secret left empty.
  • Skills installed but no tools: add the MCP server in step 1, turn it on and start a new chat.
  • No pen names appear: check you signed in to the right Reader Radius account. To change the pen names, connect again from ChatGPT and choose again.
  • Still stuck: send support the error and the app you're using, but never your password or a token.

Codex

Run the first command in a terminal, then the second. Your browser opens: sign in to Reader Radius, choose the pen names and approve. Or add the server to ~/.codex/config.toml and run the login command.

1. Terminal: add Reader Radius
codex mcp add reader-radius --url https://readerradius.com/api/mcp
2. Terminal: sign in
codex mcp login reader-radius
Or in ~/.codex/config.toml
[mcp_servers.reader-radius]
url = "https://readerradius.com/api/mcp"

Cursor

In Cursor, open Settings, then Tools & MCP, then New MCP server, and add this entry to mcp.json. Save, then click Needs login next to reader-radius. Sign in to Reader Radius, choose the pen names and approve.

mcp.json
{
  "mcpServers": {
    "reader-radius": {
      "url": "https://readerradius.com/api/mcp"
    }
  }
}

Gemini CLI

Run this in a terminal, then start gemini and run /mcp auth reader-radius. Your browser opens: sign in to Reader Radius, choose the pen names and approve.

Terminal
gemini mcp add --transport http reader-radius https://readerradius.com/api/mcp

Other MCP apps

Give the app the address in its MCP or connector settings, then sign in to Reader Radius and approve when it asks. If the app can't finish signing in, give it your API key instead, using the header below.

MCP server URL
https://readerradius.com/api/mcp
Header (API key only)
Authorization: Bearer aa_sk_...

Create the API key on Settings → Integrations. Your account has one API key, shared by every app that uses it, so replacing it means updating each of them.

REST API

For Make.com scenarios, Zapier zaps, n8n workflows, custom Node/Python scripts, third-party integrations. Bearer-token auth, JSON in, JSON out, a stable v1 URL space.

1. Generate an API key

On Settings → Integrations, find the API Key card, choose the pen names it can reach and click Generate. The key is shown once, so store it somewhere you can find it again. It starts with aa_sk_.

2. Make a request

List your connected accounts
curl -H "Authorization: Bearer aa_sk_..." \
  https://readerradius.com/api/v1/accounts
Create a post (publish now)
curl -X POST \
  -H "Authorization: Bearer aa_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from the API!",
    "accountIds": ["682..."],
    "publishNow": true
  }' \
  https://readerradius.com/api/v1/posts

Multiple pen names?

Pass an X-Profile-Id header to scope a request to a specific pen name. Without it, the request uses your primary pen name if the key can reach it, or else the first pen name the key is limited to. Discover your pen name IDs by calling GET /api/v1/profiles.

For developers: every tool and parameter

Building something yourself? The full reference lists all 388 tools with their parameters.

Your agent only sees the pen names you choose

When you approve an agent, you choose which pen names it can use. A key you create for an app can be limited the same way. That keeps, say, a virtual assistant who manages one pen name away from the others.

In a chat, switch pen names by saying “switch to my [pen name]”. Developers can find how to pick a pen name in code in the API docs.

Frequently asked questions

What does connecting an AI agent to Reader Radius do?

It lets your agent use Reader Radius for you: list your accounts, post and schedule, answer comments and DMs, check results and run ads. You stay signed in to Reader Radius, and the agent only reaches the pen names you approved.

Which AI agents work with Reader Radius?

Claude, Cowork, Claude Code, ChatGPT, Codex, Cursor and Gemini CLI have their own steps on this page. Any other app that supports MCP connects with the same address.

Do I need an API key?

Not for most agents. They sign in to Reader Radius instead. You need an API key only for scripts, Make, Zapier, n8n and apps that can't sign in.

What's the difference between connecting my assistant, the skills plugin and a key?

Connecting your assistant is what lets it work for you: it gets everything your plan includes. The skills plugin adds ready-made skills and shortcuts on top, but doesn't connect anything by itself. A key is a sign-in for scripts and apps that can't open a sign-in page.

Claude, Cowork or Claude Code: which one do I need?

Use Claude or Cowork if you'd rather not use a terminal: add the custom connector once and it works in the browser, the desktop app and Cowork. Use Claude Code if you work in a terminal. All three use the same address.

Why does ChatGPT use a different address?

ChatGPT signs in against its own address, https://readerradius.com/api/mcp/chatgpt. You still sign in to Reader Radius and choose your pen names, and there's no client ID or secret to enter.

I don't see Add custom MCP server in ChatGPT

Some ChatGPT plans and workspaces turn custom MCP servers off. If you use a work account, ask your workspace admin, or use a personal account.

Can my agent spend money on ads without me?

Amazon campaigns your agent creates always start paused, and you start them yourself. On other ad networks the agent follows what you ask, so tell it to create ads paused if you want to check them first. Ask it to show you each ad before it creates anything.

Which pen names can my agent see?

Only the ones you chose when you approved it. To change them, choose Edit pen names next to the app on Settings → Integrations (the Connect your AI page on the MCP plan).

How do I disconnect an agent?

Claude, ChatGPT, Codex and other agents you approve are listed under your connected apps on Settings → Integrations (the Connect your AI page on the MCP plan). Disconnect one and it stops working right away, without affecting the others.

I lost my client secret or API key

For your security we can't show either one again. Create a new one, then update any app or script that used the old one.

If something goes wrong

Claude or Cowork says it couldn't reach the connector

Remove the connector and add it again with the address pasted exactly, with no spaces before or after it and Advanced settings left empty. Then click Connect and sign in to the Reader Radius account that has your pen names.

My agent can't see my accounts
  1. Check the MCP connection is signed in: the skills plugin alone doesn't connect. In Claude Code, run /mcp and finish authentication for reader-radius.
  2. With several pen names, an empty result usually means the agent asked about the wrong one. Say “switch to [the pen name with accounts]” and try again.
Image upload hangs in Cowork

Cowork's sandbox blocks uploads to most domains by default. Open Settings → Capabilities → Allow Network Egress and switch it to All Domains. A single-domain allowlist won't work, because uploads go to a different subdomain each time.

Still stuck? Email [email protected] with the agent you're connecting and the exact error. Never send a password, secret or token. We usually reply within a business day.

Connect your agent

Copy the address, add it to your agent and approve the pen names it can use.