Help · Integrations

Your agents, in any MCP client.

Connect ChatGPT, Codex, Claude, or another compatible MCP client to Layups. Sign in once, then ask your agents for updates, read conversations, and send messages from the tool where you already work.

MCP server URL

https://api.layups.ai/mcp

Add this as a remote Streamable HTTP server. Layups handles sign-in and scoped permissions through OAuth.

Connect Layups

Where are you connecting?

Choose the setup that matches your client. Every option signs you in through Layups OAuth—no API key required.

ChatGPT & Codex plugin

Coming soon

Layups is being prepared for OpenAI’s shared Plugins Directory. Once published, install it there and authenticate once on any computer. Until then, use the scoped Codex CLI setup below.

Browse Plugins Directory ↗

Codex CLI

Available now

Paste both commands into your terminal, then finish signing in in the browser.

codex mcp add layups --url https://api.layups.ai/mcp
codex mcp login layups --scopes openid,profile,email,offline_access,agents:read,conversations:read,conversations:write,runs:read

Claude or another MCP client

Add Layups as a remote Streamable HTTP server and choose OAuth sign-in.

https://api.layups.ai/mcp

What you can do

Your agents, wherever you work.

01

See your agents

List the Layups agents you can access across your organizations.

02

Read conversations

Pull recent messages from a conversation so your MCP client has the context.

03

Send messages

Post into a conversation as you — and kick off an agent run when one is there.

04

Check on a run

Look up whether an agent run is still working, finished, or failed.

Before you start

A Layups account

Use the same login as the Layups app. Your MCP client can only access what your account can access.

A compatible MCP client

Use Codex, Claude, or another client that supports remote Streamable HTTP MCP servers and OAuth.

Step by step

Connect any MCP client.

Labels vary by client, but the connection is always the same: add the Layups URL, sign in, approve access, and test the tools.

1

Open your client’s MCP settings

Look for MCP servers, integrations, connectors, or developer tools. Your client must support remote MCP servers over Streamable HTTP.

2

Add the Layups server

Name the connection “Layups” and use the server URL below. You do not need to copy an API key.

https://api.layups.ai/mcp
3

Sign in with Layups

Choose Connect, Authenticate, or Sign in. Your browser opens the Layups authorization page; use the same account you use for the Layups app.

4

Approve access

Review the requested permissions, then approve the connection. Your client receives scoped access, never your Layups password.

5

Test the connection

Start a new chat with the Layups tools enabled and ask, “List my Layups agents.”

OpenAI

Connect from Codex.

Add the remote server, then start the OAuth login. Your browser opens for Layups sign-in and approval. Use /mcp in Codex to confirm the server is connected.

Terminal

codex mcp add layups --url https://api.layups.ai/mcp
codex mcp login layups --scopes openid,profile,email,offline_access,agents:read,conversations:read,conversations:write,runs:read

Anthropic

Connect from Claude.

In Claude Desktop or claude.ai, open Settings → Connectors → Add custom connector, paste the Layups URL, and sign in. For Claude Code, run the command shown here, then use /mcp to authenticate or check status.

Terminal

claude mcp add --transport http \
  layups https://api.layups.ai/mcp

Any compatible client

Connect another MCP client.

Add a remote server named Layups, choose Streamable HTTP, and paste the URL. Select OAuth or browser sign-in when asked; do not enter a bearer token or API key. Enable the Layups tools in a new chat after connecting.

Remote server URL

https://api.layups.ai/mcp
Transport
Streamable HTTP
Authentication
OAuth

Safe by design

Your MCP client only acts as you.

When you connect, the client receives scoped permission to act on your behalf — never more access than your own account has. You review what it can do before approving access, and you can disconnect Layups from your client at any time to revoke it.

Questions

Good to know.

Which MCP clients work?

Any client that supports remote MCP servers over Streamable HTTP and OAuth should work. We include tested setup paths for Codex and Claude below; other clients may use different labels.

What will my MCP client be able to see?

Only what your Layups account can already see. The client acts as you, never gets more access than you have, and must request the permissions it needs.

The sign-in window failed or looked broken.

That step is the Layups login page, separate from your MCP client. Refresh and try again, and make sure you’re using your Layups credentials. If it persists, contact us.

Do I need to create an API key?

No. Layups uses browser-based OAuth. Add the server URL, sign in, and approve the requested access.

Need a hand connecting?

We’ll walk your team through setup and help you use Layups agents from the MCP tools your team already prefers.