Connect your AI tool to Reah with Reah MCP

Summary

Connect Codex, Claude Code, Cursor or Grok Bot to your Reah account with Reah MCP. In production, Reah MCP is read-only. In your AI tool, you can ask about live Reah data such as wallet balances, card transactions and Treasury positions.

What is Reah MCP?

MCP stands for Model Context Protocol, an open standard that lets AI tools connect to external tools and data. Reah MCP is a hosted, opt-in connection. Reah runs the MCP server, and nothing is connected until you add Reah in your AI tool and complete sign-in.

Your AI app discovers the tools available to your connection. Current production MCP is read-only; the tool set can vary with flags and auth.

Reah MCP vs Reah Agent

• Reah Agent is the assistant built into your Reah workspace and Slack. See Get started with Reah Agent.

• Reah MCP lets an external AI tool, such as Codex, Claude Code, Cursor or Grok Bot, work with your Reah data from that tool. Production MCP is for reads.

Both follow your Business’s roles and approval rules.

Before you begin

• You have a Reah account with access to the Business you want to connect.

• You use one of the documented AI tools: Codex, Claude Code, Cursor or Grok Bot.

• To read data, you need access to the Business and complete OAuth consent for that Business.

How to connect your AI tool

1. In Reah, open Settings → Agent → MCP. Open the setup instructions for your AI tool. Open the setup instructions for your AI tool. Connected apps appear on the same page. URLs: /{entityId}/setting/mcp and /account/mcp-connections. Do not use an invented nested path such as /setting/agent/mcp/connected-apps.

2. Follow the instructions for Codex, Claude Code, Cursor or Grok Bot to add Reah to the tool. When prompted, sign in to Reah through OAuth.

3. On the consent screen, choose one or more Businesses and how long the connection should have access. Duration options: 1 hour, 1 day, 7 days, or Until [max expiry from server]. Review your choices and authorize the connection.

4. Return to your AI tool and try a read, such as “List the Reah Businesses I can access.” Then try “Show the wallet balances for [Business name].” Check that the response shows the Business you selected.

The connection now appears in the MCP Connected apps list on the same Settings → Agent → MCP page.

What you can read

A connected AI tool can read the following for the Businesses you authorized:

• Wallet balances

• Cards and card transactions

• Transactions

• Treasury positions

• Your own pending approvals

Try these prompts

Reads:

• “What did we spend on cards last month in [Business name]?”

• “Which wallet holds the most USDC?”

• “List my pending approvals in Reah.”

How to disconnect an app

1. In Settings → Agent → MCP, open the Connected apps list to see active connections and connection history.

2. Select the connection and choose Disconnect to revoke access.

3. To restore access after disconnecting or after access expires, connect again and review your choices on the consent screen.

Troubleshoot a connection

• A Business is missing. Check that you signed in to the Reah account that has access to that Business and selected it on the consent screen.

• The connection stopped working. Check whether it expired or was disconnected in Reah Settings. Reconnect if you still need access.

• The issue persists. Contact Reah Support with the AI tool name, the step where you got stuck and the error message. Keep access tokens private.

What to do next

• Get started with Reah Agent

Still need help?

Reach out to Reah Support through the in-app chat or visit support.reah.com for more assistance.