Connect to Kevin MCP

Add Kevin's full tool surface to Claude Code, Cursor, or any MCP-compatible client. Two minutes from here to running.

14-day free trial — no credit card required.

Your device gets 14 days of full access from the moment of first connection. After that, upgrade at iiiai.us/upgrade to keep going.

1 Get your access token

Sign up for a free trial token at iiiai.us/upgrade. Your token is scoped to your account and rotatable at any time.

Already have one? Skip to step 2.

Get free trial token

2 Find your MAC address

Kevin tracks trial access per device using your network MAC address. Run the command for your OS:

# macOS
ifconfig en0 | grep ether | awk '{print $2}'

# Linux
ip link show | grep ether | awk '{print $2}' | head -1

# Windows (PowerShell)
(Get-NetAdapter | Where-Object Status -eq Up | Select-Object -First 1).MacAddress

Your MAC looks like AA:BB:CC:DD:EE:FF. Keep it handy for the config below.

3 Add to your MCP config

Paste this into your .mcp.json (Claude Code) or MCP settings (Cursor / Windsurf):

{
  "mcpServers": {
    "kevin": {
      "url": "https://mcp.iiiai.us",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer {YOUR_KEVIN_TOKEN}",
        "X-Kevin-Mac": "{YOUR_MAC_ADDRESS}"
      }
    }
  }
}
Replace {YOUR_KEVIN_TOKEN} and {YOUR_MAC_ADDRESS} with your actual values. Never commit your token to a public repo — add .mcp.json to your .gitignore.

4 Verify the connection

In Claude Code, run:

/mcp

You should see kevin listed with a green status. If you get a 402 error, your trial has expired — head to iiiai.us/upgrade.

What's included in the trial

Bus tools

Publish messages, walk the LVC snapshot, subscribe to real-time event streams from Kevin's Mx bus.

Vault tools

Read and write structured markdown holons from Hank. Full path traversal of your Kevin knowledge vault.

Service tools

Start, stop, and inspect Kevin platform services. Get live status across the Kevin family.

SSE stream

Subscribe to live event streams from any bus subject. Persistent connection through nginx.

After your 14-day trial

When your trial expires, all MCP calls return HTTP 402 with a link to the upgrade page. Your data and config are preserved — you pick up exactly where you left off after upgrading.

View upgrade options Talk to us

Troubleshooting