External Agents (MCP)

Let your other agents talk to Chalie

Chalie can act as a central hub for all your AI agents. When you connect an external agent (like Claude Code, Cursor, or Windsurf) to Chalie’s MCP server, that agent can ask Chalie questions on your behalf — check your calendar, look up contacts, search your documents, and more.

This means your coding agent can ask “What meetings does Dylan have this afternoon?” without you having to context-switch.

How it works

Chalie runs an MCP (Model Context Protocol) server alongside its main interface. External agents connect over HTTP, authenticate with a token, and call the talk_to_chalie tool to send messages. Chalie processes each message through its full reasoning pipeline and returns a response.

Each agent gets its own conversation channel, so exchanges stay organized and isolated.

Setup steps

1. Check that the MCP server is enabled

Open the Brain dashboard and click the MCP Server tab. The toggle should show “Enabled”. The default port is 8462 — note this if you’ve changed it.

2. Copy the connection token

In the same MCP Server tab, you’ll see a token field. This is the bearer token your agent will use to authenticate. Click “Copy” to grab it.

If no token is shown, click Regenerate Token to create one.

3. Ask your agent to configure itself

Tell your agent:

“Read docs/for_agents/MCP_SETUP.md in the Chalie repository and configure the MCP connection on my behalf.”

Your agent will ask you for the host address and token (from steps 1 and 2), then handle the rest of the configuration automatically.

4. Verify

Once configured, ask your agent something like “Ask Chalie what’s on my calendar today.” If it responds with your actual schedule, you’re all set.

What agents can ask Chalie

Anything you’d ask Chalie yourself:

• “What meetings do I have this week?”
• “Send a reminder about the deployment at 3pm”
• “What’s the weather forecast for tomorrow?”
• “Find the document about the API migration”
• “What’s Maria’s email address?”

Getting notified about agent conversations

Agents can ask Chalie to loop you in on an exchange. When they do, Chalie will proactively message you in your main chat to let you know what was discussed. This is useful for anything involving decisions or actions you should be aware of.

Managing access

From the Brain dashboard you can:

• Disable the MCP server entirely — toggle it off in the MCP Server tab
• Revoke and regenerate tokens — click Regenerate Token to invalidate the old one
• Control which tools agents can use — go to the Policies tab, select the “External Agent” subtab, and set per-tool permissions

Agent setup reference

For detailed setup instructions (including what to ask your user for), see the MCP_SETUP.md file in the Chalie repository. This document is written specifically for agents to follow during initial configuration.