Skip to content
Swytchcode logo Swytchcode logo Swytchcode Docs docs

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

Terminal window
npm install -g swytchcode

Use swy as a shorter alias for swytchcode.

Step 2: Initialize Swytchcode for Hermes

Terminal window
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
  • ~/.hermes/config.yaml with the MCP server configuration

Step 3: Fetch an integration

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

Terminal window
swy search

Fetch one, such as Stripe:

Terminal window
swy get stripe

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

Add a specific method:

Terminal window
swy add method stripe.charge.create

Add a workflow:

Terminal window
swy add workflow stripe.checkout

Or add everything from a project:

Terminal window
swy add method --all stripe

Verify the added tools:

Terminal window
swy list tooling

Note: Hermes supports separate add method and add workflow commands, and these are also exposed as MCP tools such as swytchcode_add and swytchcode_add_workflow.

Step 5: Start the MCP server

The MCP server starts automatically when Hermes connects through the config written during initialization. If you want to start it manually:

Terminal window
swy mcp serve

Step 6: Use Hermes

Open your project in Hermes. The agent now has access to the Swytchcode MCP tools, including workflow-aware tooling.

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

Example projects

Browse all examples →

Zoom via MCP

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