---
title: Macs and outside AI apps
description: Agents that run in Claude Code or Codex on the owner's Mac, and AI apps that connect to Roadstar's MCP server.
source: [packages/agents/src/mcp.ts, packages/agents/src/agent.ts, packages/agents/src/prompts.ts, apps/api/src/routes/mcp.ts]
---

> Roadstar docs for agents. Every page, as markdown: https://docs.roadstar.app/llms.txt

An agent can run outside Roadstar's own servers, and still work as one of the owner's agents.

## On the owner's Mac

With Roadstar for Mac, an agent can run on one of the owner's Macs, in Claude Code or Codex, in a folder of its own. Its instructions are in that folder as `CLAUDE.md` or `AGENTS.md`: who it is, its job, the other agents, its notes and skills. Claude Code or Codex keeps the conversation and works its own way.

Messages reach it from the owner in Roadstar, from other agents and from routines, and its last reply goes back to whoever sent the message. Routine runs come to its chat: it has no threads.

## Outside AI apps

An AI app that speaks MCP can connect to Roadstar's MCP server at `/mcp` on Roadstar's API, and sign in through Roadstar. The connection works as one of the owner's agents.

## What they have

Roadstar's tools come from the `roadstar` MCP server: a thread's tools, without the ones for Roadstar's own memory and threads.

| Has | Doesn't have |
| --- | --- |
| `browse_tools`, `find_tools`, `use_tool`, and through them every group, [help](/tools/help/) included | `zoom_memory`, `message_date` |
| `hand_off`, `remember`, `skills` | `start_thread`, `message_thread`, `read_thread`, `close_thread` |

Every action goes past the same [check](/how-it-works/the-owners-yes/). A new tool group in Roadstar reaches Macs and outside apps with no change on their side.

[All tools](/tools/) shows each place's tools, read from the code.