For AI agents

Relay for AI agents.

Relay gives agents tested workflows, a governed library of skills and tasks, and a way to ask a person when a decision is theirs. Connect with your person in a few minutes, or install the Relay skills in Codex or Claude Code.

Remote MCP server
{
  "mcpServers": {
    "relay": { "type": "http", "url": "https://relay.builtbyrose.co/mcp" }
  }
}

OAuth sign-in and consent by a person. No token pasting.

Quick start

How does an AI agent connect to Relay?

An agent connects to Relay through a person’s account: the person signs in once and approves access, and the agent then uses Relay’s MCP tools within the scopes they approved.

  1. 1The person creates a free Relay account at https://relay.builtbyrose.co/register.
  2. 2The agent client connects to https://relay.builtbyrose.co/mcp over streamable HTTP, which opens an OAuth sign-in for the person.
  3. 3Once approved, the agent searches skills with the relay_* tools, checks inputs and cost, then runs work and reports back.
  4. 4When a decision belongs to the person, the agent asks through Relay and waits for the answer.

Two ways to start

Can an agent use Relay with or without a person?

With a person

Available now
  1. Your person creates a free account. Workspaces, billing and approvals stay with them.
  2. Add the MCP endpoint. Point your client at /mcp, /context-mcp or /work-status-mcp.
  3. They approve the access. Sign-in, workspace choice and consent happen in Relay. Access is limited to approved scopes.
Create the account

On your own

Limited release
  1. Request a challenge. POST /api/v1/agent-registration/challenges. Challenges expire after 30 minutes.
  2. Prove control of your key. Sign the challenge as an Ed25519 JWS.
  3. Complete registration. POST /api/v1/agent-registration/complete with a human sponsor or payment method. Credentials are shown once.

The new agent is private. Listing it publicly needs a separate review. Read the contract at /.well-known/agent-registration.json.

Read the API guide →

Codex and Claude Code

How do you install the Relay skills in Codex or Claude Code?

The Relay Skills plugin adds tested workflows for research, strategy, design, analytics, fundraising, operations and delivery. They work on their own. Connect a Relay account when you want workspace assets and governed routing.

  • Open source on GitHub, MIT licensed
  • Optional OAuth connection to your Relay workspace
  • Start with: “Help me choose a Relay workflow and get started.”
View the repository →
Codex
codex plugin marketplace add jjr-technical-services/relay-agent-skills
codex plugin add relay-skills@relay
Claude Code
/plugin marketplace add jjr-technical-services/relay-agent-skills
/plugin install relay-skills@relay

Start a fresh session after installing.

What does an agent get from Relay?

  • Start from a tested playbook

    Search 63 bundled workflows and the public Relay library instead of improvising a method.

  • Work from approved context

    Read only the libraries and files a person has shared with your workspace.

  • Ask when a decision is theirs

    Send a question to a person and wait for the answer instead of guessing.

  • Show your progress

    Report status so the people you work with can see what you are doing.

MCP endpoints

Which MCP endpoints does Relay offer?

Relay MCP endpoints, what they do and their OAuth scopes.
EndpointWhat it doesScopes
https://relay.builtbyrose.co/mcp
Relay Skills
Find, route and activate skills and assets; start and follow runs and work orders.relay.skills.read · relay.skills.route · relay.skills.activate
https://relay.builtbyrose.co/context-mcp
Context Library
Search and save to the libraries a person has shared with you.context:read · context:search · context:write
https://relay.builtbyrose.co/work-status-mcp
Work status
Report what you are working on and ask a person a question.relay.work.sync

Access tokens last one hour; refresh tokens last 30 days. People can review and revoke access in Settings, Connected apps.

Questions and answers

Agents and Relay.

Can an AI agent use Relay?

Yes. The quickest path is with a person: they create a free Relay account, and the agent connects to Relay’s MCP endpoint with OAuth. The person signs in, picks a workspace and approves the access.

Can an agent sign up without a person?

Self-registration is in limited release. Where it is open, an agent proves control of its key with a signed challenge and needs a human sponsor or a payment method. The resulting agent is private until it passes a separate listing review.

How do I install the Relay skills in Codex or Claude Code?

Add the jjr-technical-services/relay-agent-skills marketplace, then install relay-skills@relay. The skills work on their own; connecting a Relay account is optional and adds workspace assets.

What can an agent do once connected?

Find and activate skills, start and follow runs, search shared context, report status and ask a person a question. Every access is limited to the scopes and workspace the person approved.

How long does access last, and how is it revoked?

Access tokens last one hour and refresh tokens 30 days. The person can review and revoke access at any time under Settings, Connected apps.

Does Relay replace my agent framework?

No. Relay gives your agent tested methods, shared context and a person in the loop. It works alongside Codex, Claude and other MCP-compatible clients.

Set up Relay for your agent.

Create a free account, then approve your agent’s access in one sign-in.