Connect a server
- Open Settings → MCP servers and choose Add server.
- Enter a name, a slug, and the server’s MCP endpoint URL, such as
https://mcp.example.com/mcp. The slug is the short name agents call the server’s tools by. r5d connects over HTTPS with Streamable HTTP (or the older HTTP+SSE transport) and supports servers built for both the current and earlier MCP revisions. - Choose how r5d authenticates:
- OAuth: add the server, then select Connect and sign in to the service in the window that opens. r5d refreshes the access token when it expires. If the service needs you to sign in again, the server shows Authorization required; select Reconnect.
- Bearer token: paste a token the service gave you. r5d sends it in the
Authorizationheader and never shows it again. - No authentication: for servers that need none.
- Choose All projects or Selected projects only. Conversations in your account workspace use servers available in all projects.
How agents use MCP tools
Agents reach every server through two tools of r5d’s own: lookup_mcp lists the chat’s servers, the instructions each gives for its tools, and their tools with what they take, and call_mcp calls one of those tools, naming the server by its slug in Settings and the tool by its name. The agent looks a server up before it first uses it in a chat. r5d checks the arguments of a call against the tool’s description of its input before anything is sent, so a malformed call is refused without reaching the server, and the agent corrects it. The servers and their tools aren’t part of the agent’s instructions or of its tool list, so adding, removing or reconnecting a server, or a change in its tools, doesn’t disturb chats that are running: they reuse what the model provider already cached instead of starting over, and pick up the change when the agent looks the servers up. In a chat’s context panel, All MCP servers turns the two tools off for the chat, and each server’s own switch decides whether the agent can look it up and call it. Tool calls appear in the chat with the server name and the tool’s title. A call folds into the agent’s other tool work, unless it involves you: a call with an interactive view, or one whose server asks for your input, shows on its own row, also after it finished. Server instructions, tool descriptions and tool annotations come from the server’s operator, not from you or r5d. The agent treats them as information, never as permission: a tool described as read-only or safe does not authorize purchases, messages, deletions or data transfers you did not ask for. You can list a chat’s servers too:r5dctl -s SESSION_ID get mcp-servers for a chat or r5dctl -p PROJECT get mcp-servers for a project’s chats lists each server’s slug, its status as last checked, the tools it offers and its instructions.
Results follow the same rules as r5d’s own tools:
- Text becomes the tool result.
- Images are shown to the agent within the usual image limits and saved with your chat’s files.
- Files the server returns are saved with your chat’s files, and the agent receives their paths.
- A server that reports an error, or rejects a call before doing anything, gives the agent an error it can correct.
When a server asks for input
A server can ask you to complete a bounded form or open a web page. The chat identifies the requesting server and offers explicit accept, decline and cancel actions. The request doesn’t pause the agent: it goes on with work that doesn’t need the call’s result, or waits or ends its turn, and the request stays open in the chat until you answer it, like the agent’s own questions. When you answer, the call continues and the agent receives its result, whether it is still working, waiting or has finished its turn.Forms
Supported forms contain simple text, number, boolean or selection fields. Review the values before accepting. Unsupported complex forms and requests recognized as asking for secrets are refused. Detection is only a heuristic: never enter passwords, API keys, tokens or payment credentials in these forms. A server needing secrets should use a secure external page instead. Accepted form answers are encrypted in storage and sent to the requesting server, not added to your transcript or the agent’s model context. The server still receives your answers and could include them in its own results, so share only what you intend that server to receive.External pages
A server sometimes needs you before it can finish a call: to sign in to another service, approve a payment, or enter a secret that should not pass through r5d. It sends r5d a web page for you to open, and the call waits for you. The chat then shows a card with the server’s name, its message, and the page’s full address with the host highlighted. The message comes from the server, not from r5d. Check the address before you open it.- Select Open page. The page opens in a new browser tab; r5d never opens it on its own and cannot see what you do there.
- Finish on the page, then return to the chat and select Continue. r5d asks the server to complete the call, and the agent receives its result.
- If you do not want to go ahead, select Decline or Cancel. The server decides what happens next, usually ending the call.
Files
Some servers exchange files through MCP’s draft file transfer extension (SEP-2631). r5d supports it when the installation enables it; it is off by default. When disabled, tools requiring unsupported file inputs are unavailable; optional file inputs are omitted while usable non-file alternatives remain. When enabled, the agent can pass an authorized project/chat file to a compatible tool, and returned files are checked and saved with your chat’s files.Interactive views
Some MCP tools come with an interactive view, such as a chart, a form, or a dashboard. r5d shows these views in the chat, below the tool call. You can open a view in full screen, or dock it as a picture-in-picture panel that stays visible while you scroll. Views require an enabled sandbox host and run in isolated frames on a site separate from r5d.dev. Per-server origins separate different servers’ DOM and storage. Network requests are restricted by the view’s content security policy; this is not a guarantee against all browser side channels. Where r5d.app hosting is enabled, it is a shared untrusted-app domain, not a dedicated private domain. A view can:- call its own server’s tools that are meant for views, and read its server’s resources;
- ask to open a link, which r5d shows to you for confirmation;
- propose a message to the conversation, which r5d sends only after you confirm it.
Limitations
- r5d connects to remote servers over HTTPS. Servers that run as a local process (stdio) are not supported.
- Each server’s tools are available to agents only while the server is enabled, reachable, and signed in.
- A chat’s agent can reach at most 128 MCP tools across its servers. Turn off servers a chat does not need in its context panel to bring others within reach.
- Forms use a bounded subset of standard field types, not arbitrary nested schemas. Requests for model generation (sampling) are unsupported. A long-running task that asks for input is cancelled; interactive views cannot use the same durable input flow.