MCP server

Connect Leroy to your AI coding tool — Claude Code, Codex, or the Claude app— so you can find tickets, pull the context for the work in front of you, open new tickets, and see what's waiting on you, all without leaving your editor. You sign in with your Leroy account: if you have access to Leroy, you have access to the MCP.

01 Install

Pick your tool. Each connects to the same server — https://mcp.useleroy.com/mcp — and signs you in through the browser with your Leroy account.

Add the server in your terminal:

bash

claude mcp add --transport http leroy https://mcp.useleroy.com/mcp

Sign in: run /mcp in a Claude Code session and follow the browser prompt to sign in to Leroy.

Use the Codex app's settings — no terminal needed:

Open Settings → MCP servers, then Add server.
Set the transport type to Streamable HTTP.
Name it leroy and paste the URL https://mcp.useleroy.com/mcp, then Save.
On the new leroy row, click Authenticate and sign in through the browser.

Prefer the CLI? Enable Codex's remote MCP client (add experimental_use_rmcp_client = true under [features] in ~/.codex/config.toml), then:

bash

codex mcp add leroy --url https://mcp.useleroy.com/mcp
codex mcp login leroy

Add Leroy as a custom connector (Pro, Max, Team, or Enterprise plans):

Go to Settings → Connectors.
Click + Add custom connector.
Paste the URL https://mcp.useleroy.com/mcp and click Add.
Sign in through the OAuth prompt. (Leave the advanced client ID / secret fields blank — Leroy registers automatically.)

Tip. The tool list is fetched when your client connects. If you don't see the leroy_* tools, reconnect — in Claude Code, run /mcp again.

02 Verify it works

Once connected, the leroy_* tools are available. Ask your tool something that forces a call — for example:

prompt

Use leroy to show what's waiting on me

That calls leroy_my_attention and lists the reviews and approvals Leroy is waiting on you for.

03 What you can do

From any connected tool you can ask plain-English questions about your pipeline, find and open tickets, pull a ticket's full context to start coding, list the PRs Leroy has opened, and check what needs your review. A few of the tools:

Tool

What it does

leroy_ask_leroy

Ask a question about your work; get a synthesized answer with the relevant ticket ids.

leroy_find_tickets

Filter tickets by status, keyword, or ref.

leroy_get_ticket_context

Everything you need to start a ticket — body, related code, prior decisions.

leroy_create_ticket

Open a ticket — Leroy works it now, or save it for later.

leroy_my_attention

What Leroy is waiting on you for.

See the full Tool reference →

One account per connection. The MCP is scoped to the account you signed in as. To work across accounts, add the server again and sign in to the other one.

← Prev

Connect your tools

Tool reference