An **agent token** is a long-lived key that lets a script, CI job, or MCP client that can't open a browser use RealtyPad. If your client can sign in through the browser (Cursor, Claude, ChatGPT), you don't need one. See [How do I connect Cursor or another MCP client?](https://support.realtypad.ai/hc/faq/articles/1787171770-how-do-i-connect-cursor-or-another-mcp-client) or [Connect Claude, Claude Code, or ChatGPT to RealtyPad](https://support.realtypad.ai/hc/faq/articles/1791296941-connect-claude-claude-code-or-chat_gpt-to-realty_pad).

## Create a token

1. Switch to the workspace you want the agent to use (account menu → **Switch workspace**)
2. Open the account menu (top right) → **Agent & API**
3. Under **Long-lived agent token**, click **Mint agent token**
4. Copy the token right away. It's shown **once** and won't be shown again

Things to know:

- A token lasts about **90 days**, then stops working. Mint a new one when it expires.
- A token only works in the workspace you were in when you minted it.
- You need a verified email to mint a token.
- Each token counts as one **Agent Connection** on your plan.

## Use the token

Send it as a Bearer header:

- **MCP clients:** put `Authorization: Bearer <agent-token>` in the server's `headers`. **Agent & API → Copy config** gives you a ready-made config.
- **REST API:** send the same header to `https://app.realtypad.ai/api`, for example `/api/deals?limit=5`.

Treat it like a password. Don't paste it into chats, tickets, or shared repos.

## Replace a token

Mint a new one the same way. Minting a new token **automatically retires your previous agent token** in that workspace, so the old one stops working. Update every place that used the old token.

This also covers a lost or leaked token: mint a new one and the old one is cut off.

## See and remove connections

1. Open the account menu → **Billing**
2. Under **Seats, agents & automation**, the table lists every Agent Connection with its **Type** (**Agent token** or **Browser OAuth**) and **Last used**
3. Click **Remove** next to a connection

Removing a connection stops its tokens from reaching RealtyPad right away, and frees the slot on your plan. Only workspace **owners** and **admins** can remove connections.

## "Connection limit reached"

If minting fails because the workspace has used all its Agent Connections, remove one you no longer use (see above) or upgrade your plan. See [Plans compared, and what counts as an Agent Connection](https://support.realtypad.ai/hc/faq/articles/1790955224-plans-compared-and-what-counts-as-an-agent-connection) and [MCP troubleshooting](https://support.realtypad.ai/hc/faq/articles/1791383431-mcp-troubleshooting-authorization-connection-limits-and-the-wrong-workspace).

## Still stuck?

Contact us through live chat or **support@realtypad.ai**, Monday to Friday, 9am–5pm Central.
