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.
| Agent | Made by | How it connects | Authentication | Guide |
|---|---|---|---|---|
| Claude (web and desktop) | Anthropic | Add Reader Radius in Claude's settings with one address | Sign in when asked | Setup steps |
| Cowork | Anthropic | The same Claude setting, plus the optional skills plugin | Sign in when asked | Setup steps |
| Claude Code | Anthropic | One line in the terminal (steps below), plus the optional skills plugin | Sign in when asked | Setup steps |
| ChatGPT | OpenAI | Add Reader Radius in ChatGPT with its own address | Sign in when asked | Setup steps |
| Codex | OpenAI | One line in the terminal, or its settings file (steps below) | Sign in when asked | Setup steps |
| Cursor | Anysphere | Cursor's settings (steps below) | Sign in when asked | Setup steps |
| Gemini CLI | One line in the terminal (steps below) | Sign in when asked | Setup steps | |
| Other AI apps | The Reader Radius address in the app's settings | Sign in when asked, or use a key if the app can't sign in | Setup steps | |
| Make, Zapier, n8n and your own scripts | Our developer tools (steps below) | A key from your account | Setup 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.
| Surface | Used by | Authentication | What it gives you |
|---|---|---|---|
Connect your assistanthttps://readerradius.com/api/mcp | Claude, 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, approve | Everything your plan includes |
| Skills plugin | Claude Code, Cowork and Codex | None of its own: it uses your Reader Radius connection | Ready-made skills and shortcuts for posts and campaigns in Claude Code and Cowork. It doesn't connect your account. |
| Key for scripts and apps | Make, Zapier, n8n, your own scripts and apps that can't sign in | A key you create on Settings → Integrations (the Connect your AI page on the MCP plan), limited to the pen names you choose | Everything 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
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
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:
Terminalcurl -H "Authorization: Bearer aa_sk_..." \ https://readerradius.com/api/v1/accounts
- 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.
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 monthMake 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.
- Connect Reader Radius to Claude or ChatGPT, then start a new chat.
- Paste the request. If you write under more than one pen name, say which one.
- 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.
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 growingMake 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.
- Paste the request into a new chat.
- The first time, check a number or two against your Reader Radius dashboard.
- 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.
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 okShow 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.
- Paste the request and read the drafts.
- Approve in the chat, for example: send 1 and 3, make 2 shorter.
- 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.
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 itselfSave 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.
- In Claude's settings on claude.ai, add Reader Radius under Connectors. The Claude setup steps show how.
- Make the page in a Claude chat, Cowork or Claude Code, then paste the request.
- The first time the page asks to use Reader Radius, approve it. After that, open it any time.
- 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.
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 computerMake 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.
- On the Connect your AI page, create a key and limit it to the pen names this page needs.
- Ask Claude Code to keep the key in your computer's settings rather than in a file.
- 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.
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 pageMake 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.
- Change the budget in the request to yours, then paste it.
- Read the suggestions. Each one names the campaign and the reason.
- 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.
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 bookHelp 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.
- Paste the request and answer each question. If you're not sure, say so and it will suggest a starting point.
- Read the plan: which networks, the daily budget, who it reaches and the tests it suggests.
- 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
- In Claude or Cowork, open Settings → Connectors → Add custom connector.
- Name it Reader Radius and paste the address into “Remote MCP server URL”. Leave Advanced settings empty.
- Click Add, then Connect.
- 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
- Settings → Plugins → click the + next to Personal.
- Add a marketplace from URL and paste:
https://github.com/chellehoniker/claude-code-author-automations
- Click Sync, then click the + next to Reader Radius to install. Older clients may show author-automations-social; the internal identifier is unchanged.
- 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.
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
/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:
Post a Trial Reel about my new cover on Friday at 6pm.
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
- In ChatGPT, open Plugins, click + and choose Add custom MCP server.
- Name it Reader Radius and paste the URL above. It ends in
/chatgpt, which is ChatGPT's own address. - Leave authentication on OAuth. Don't enter a client ID or secret.
- 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/chatgptwith 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.
codex mcp add reader-radius --url https://readerradius.com/api/mcp
codex mcp login reader-radius
[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.
{
"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.
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.
https://readerradius.com/api/mcp
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
curl -H "Authorization: Bearer aa_sk_..." \ https://readerradius.com/api/v1/accounts
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/postsMultiple 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
- Check the MCP connection is signed in: the skills plugin alone doesn't connect. In Claude Code, run
/mcpand finish authentication for reader-radius. - 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.