Hermes

This quickstart shows how to connect Hermes to Swytchcode using the CLI and MCP setup.

Step-by-step setup

Step 1: Install the Swytchcode CLI

npm install -g swytchcode

irm https://cli.swytchcode.com/install.ps1 | iex

curl -fsSL https://cli.swytchcode.com/install.sh | sh

Use swy as a shorter alias for swytchcode.

Step 2: Initialize Swytchcode for Hermes

cd /path/to/your/project
swy init --editor=hermes --mode=sandbox

This creates:

.swytchcode/ with tooling.json - the trust boundary that lists exactly which tools Hermes is allowed to call
AGENTS.md in the repo root - the agent contract file describing available tools and conventions for Hermes to follow
the Swytchcode MCP server registered with Hermes. When init runs in a terminal, it runs hermes mcp add: Hermes connects to the server, lists its tools and asks you to confirm. Otherwise init prints the command to run yourself:

hermes mcp add swytchcode --command swytchcode --args mcp serve

Step 3: Fetch an integration

Search for available integrations (or browse the full list at swytchcode.com/apis):

swy search

Fetch one, such as Stripe:

swy get stripe

Step 4: List available methods

swy list methods

This lists every method from the integrations you’ve downloaded, so you can see what the Stripe bundle exposes before you enable a tool.

Step 5: Add tools to the trust boundary (`tooling.json`)

Add a specific method:

swy add method stripe.charge.create

Or add everything from a project:

swy add method --all stripe

Verify the added tools:

swy list tooling

Note: add method is also exposed as the MCP tool swytchcode_add.

Step 6: Start the MCP server

Hermes starts the MCP server itself through the server registered in Step 2. If you want to start it manually:

swy mcp serve

Step 7: Use Hermes

Open your project in Hermes. The agent now has access to the Swytchcode MCP tools.

You can ask prompts such as:

List all available Stripe methods and create a charge.

Hermes will:

call swytchcode_list with the tooling filter to confirm enabled tools
call swytchcode_info to inspect schemas
generate runtime code that uses swy exec

Use Hermes as a personal agent

To drive Hermes from Telegram, WhatsApp, Slack or a terminal chat and let it run API calls for you, set it up with --operator instead. Hermes then sets integrations up on its own, tells you in the chat when an app needs connecting, and every call that changes something waits for your approval:

swy init --operator --editor=hermes --project ~/agent-swy
swy login
swy doctor --agent hermes --project ~/agent-swy

See the Personal agents guide for connecting apps and, optionally, locking Hermes down before you use real accounts.

Example projects

Browse all examples

Zoom via MCP

Drives Zoom entirely through Swytchcode as an MCP server in Claude, Cursor, Codex, Copilot, or Windsurf.