Connect an AI assistant (MCP)

Connect your assistant to eReader Relay to find feeds, save articles to an existing reading list, or send a blog post to one of your devices. The assistant works with the account you approve and uses your usual plan allowances and delivery limits.

You can also import reports and documents containing Markdown, HTML tables, supplied images, and chart data. Relay can turn them into an EPUB for your library or devices.

Connection settings

Open Account → Connected apps in Relay to find your server URL and manage approved applications.

Use the full URL including /mcp. No API key or locally installed Relay server is needed. If you are testing a preview, copy the URL from Connected apps on that preview and use a distinct name such as eReader Relay Preview. Preview and production data and authorizations are separate; connecting to production requires signing in again.

Choose your app

These instructions were checked against the linked official client documentation on 29 September 2026. Menus and availability depend on your installed version, account, and workspace policy. The common MCP standard defines how clients connect; each app provides its own setup interface.

ChatGPT on the web

1. In ChatGPT settings, open Security and login and enable Developer mode, if available.
2. Open Plugins and use the plus button to add a connection.
3. Name it eReader Relay, add a description such as “Manage my reading lists and send articles to my eReader”, and enter the server URL above.
4. Use OAuth when an authentication choice appears. Leave optional client credentials empty.
5. Create the connection, sign in to Relay, approve the requested access, and review the discovered tools.
6. Start a new conversation and select the connection from the tools menu.

If you cannot add a custom connection, check your workspace's developer-mode policy with its admin. Web connections are configured separately from local desktop MCP settings.

Official ChatGPT connection guide

Codex and ChatGPT desktop

In versions with Plugins → MCPs, choose Add → Connect to a custom MCP. Other versions expose Settings → MCP servers → Add server. Enter the connection settings above, save, then select Authenticate when prompted. Complete Relay's sign-in and consent screen. Restart the connection or app if requested and start a new task.

For Codex CLI:

codex mcp add ereader-relay --url https://ereaderrelay.com/mcp
codex mcp login ereader-relay
codex mcp list

Alternatively, add this to ~/.codex/config.toml, then run the login command:

[mcp_servers.ereader-relay]
url = "https://ereaderrelay.com/mcp"

The desktop app, Codex CLI, and Codex IDE extension share this configuration on the same Codex host. ChatGPT web does not read this local file. Use /mcp in Codex to check the available tools.

Official desktop and Codex MCP guide

Claude web and Claude Desktop

1. Open Customize → Connectors.
2. Use + → Add custom connector and enter Relay's server URL.
3. Leave advanced OAuth credentials empty and choose Add.
4. Connect the new entry, sign in to Relay, and approve access.
5. Enable the connector in the conversation's tools menu.

Use a remote custom connector for Relay. Team and Enterprise workspaces may need an owner to add the connector first; each person then connects their own Relay account.

Official Claude remote connector guide

Claude Code

Register Relay for your user account:

claude mcp add --transport http --scope user ereader-relay https://ereaderrelay.com/mcp

Open Claude Code, run /mcp, select ereader-relay, and authenticate in the browser. Newer releases also support claude mcp login ereader-relay directly from your terminal. Finish Relay's consent screen and check that the tools appear in /mcp.

Official Claude Code MCP guide

OpenCode

For OpenCode V2, add and authenticate the server:

opencode mcp add ereader-relay --global --url https://ereaderrelay.com/mcp
opencode mcp auth ereader-relay
opencode mcp list

You can also run /mcps inside OpenCode and select Relay to sign in. OAuth is enabled by default.

If configuring V2 by hand, merge this entry into your opencode.jsonc:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "ereader-relay": {
        "type": "remote",
        "url": "https://ereaderrelay.com/mcp"
      }
    }
  }
}

OpenCode V1 places the ereader-relay entry directly inside mcp, without the servers wrapper. After saving, use opencode mcp auth ereader-relay to sign in. Keep OAuth enabled in either version.

Official OpenCode V2 guide · OpenCode V1 guide

Cursor

Merge this entry into ~/.cursor/mcp.json for personal use, or .cursor/mcp.json for a project:

{
  "mcpServers": {
    "ereader-relay": {
      "url": "https://ereaderrelay.com/mcp"
    }
  }
}

Save and restart Cursor. Open Customize → MCPs (or MCP settings in older versions), connect Relay, and complete the browser authentication prompt. Make sure its tools are enabled for Agent.

Official Cursor MCP guide

VS Code with GitHub Copilot

Run MCP: Add Server from the Command Palette, choose an HTTP server, and enter Relay's URL. Choose a name and whether to save it for your user or workspace. Start the server and complete the trust and browser sign-in prompts.

For a workspace, the equivalent .vscode/mcp.json entry is:

{
  "servers": {
    "ereader-relay": {
      "type": "http",
      "url": "https://ereaderrelay.com/mcp"
    }
  }
}

Use MCP: List Servers to inspect the connection, then enable Relay's tools in Copilot Chat's tool picker. Preserve any existing server entries when editing configuration files.

Official VS Code MCP guide

Check the connection

Start with a request that only reads your account:

Use eReader Relay to show my reading lists, devices, and remaining plan allowances.

Check that the returned account and list names are yours. Then try:

• “Find the RSS feed for https://blog.cloudflare.com and add it to my Weekly Tech reading list.”
• “Save this article to my Weekend reading list: [article URL].”
• “Send this blog post to my Kindle now: [article URL].”
• “Check the status of that delivery.”

Create the reading list and register its device in Relay first. Use their actual names so the assistant can select the intended destination. A send request queues preparation and delivery; ask for its status afterward. Email accepted by the delivery provider does not confirm that your physical device has downloaded it.

Newsletters and subscriptions

The assistant can prepare a private subscription inbox and add an observed newsletter sender to a reading list. You may still need to enter that address on the publisher's website, solve a CAPTCHA, or confirm the subscription. A sender becomes available after its first email arrives.

MCP does not purchase paid newsletter subscriptions or change your Relay billing plan. Open Relay's billing page to manage your plan. See Subscription inboxes for the full newsletter workflow.

Permissions and disconnecting

Relay asks you to approve read, write, and send access. The connected assistant can only operate on your account, and your source, inbox, article, and delivery allowances still apply. Your assistant may ask for an additional confirmation before making changes or sending an article.

To revoke access, open Account → Connected apps in Relay and select Disconnect beside the application. Remove or disable the connection in the assistant too. Reconnecting requires a new authorization.

Troubleshooting

The guides above describe each client's documented connection flow. Client versions and workspace restrictions can affect compatibility; a client appearing here is not a promise that every release has been tested with Relay.