Agent-to-Agent Setup

Connect your AI tools to Chalie's MCP server.

Connecting your tools to Chalie

Chalie’s MCP server is on by default. All you need is the server address — there is no token to copy and no header to set.

Step 1: Find your server address

The MCP server runs on port 8462 by default, on the same machine as Chalie.

  • Same machine: http://localhost:8462
  • Local network: http://<your-machine-ip>:8462 (e.g. http://192.168.1.50:8462)
  • Named host: http://chalie.local:8462

To check or change the port, open the Brain dashboard (the 🧠 brain icon in the top-right corner), go to the MCP page, and look under the Inbound section. The status line there reads “Listening on port N” while the server is up, or “Not listening” with the reason. Changing the port or switching Server enabled off takes effect immediately — no restart.

Step 2: Configure your MCP client

Add this to your MCP configuration file:

{
  "mcpServers": {
    "chalie": {
      "type": "http",
      "url": "http://<HOST>:<PORT>/mcp"
    }
  }
}

Replace <HOST> and <PORT> with your values from step 1. No Authorization header is needed.

Where to put the config

Tool Config file
Claude Code .mcp.json in your project root
Cursor MCP settings in Cursor preferences
Windsurf MCP configuration in settings
Custom client Depends on your MCP library

Step 3: Verify the connection

Once configured, your tool should discover a talk_to_chalie tool. Try sending a test message:

“Say hello to Chalie and ask what it can help with.”

If you get a response, you’re connected.

Troubleshooting

Problem Fix
Connection refused Check that Chalie is running and the MCP page in the Brain dashboard says “Listening on port N”
Tool call denied The External agent policy for that tool is Ask or Deny — open Policies in the Brain dashboard, switch to the External agent context, and set it to Allow
Tool not found Make sure the URL ends in /mcp and the config is saved
Timeout Check that your tool can reach the host — try curl http://<HOST>:<PORT>/mcp