Agent tokens: create, replace, and revoke

D

Diego Alejos

Last updated on Oct 12, 2026

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? or Connect Claude, Claude Code, or ChatGPT to RealtyPad.

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 and MCP troubleshooting.

Still stuck?

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