@mesheshq/mcp-server

MCP server for Meshes — emit events, manage workspaces, create routing rules, and inspect deliveries from any MCP-compatible client.

Features

• Emit Events — send product events (signups, payments, cancellations) to Meshes
• Manage Workspaces — list and configure workspaces
• Workspace Discovery — inspect available workspace event types and resources
• Routing Rules — create and update event routing rules
• Connections — manage integration connections (HubSpot, Salesforce, Slack, Mailchimp, etc.)
• Delivery Status — inspect event delivery logs and retry status
• Embedded Sessions — mint, list, refresh, and revoke workspace, dashboard, or resource-scoped sessions

Setup

Create a free Meshes account and create Machine Keys in the dashboard under Profile → API Keys.

Claude Code

claude mcp add meshes \
 -e MESHES_ACCESS_KEY=your_access_key \
 -e MESHES_SECRET_KEY=your_secret_key \
 -e MESHES_ORG_ID=your_org_id \
 -- npx -y @mesheshq/mcp-server

Cursor

Open Cursor Settings → MCP → Add new global MCP server:

{
  "mcpServers": {
    "meshes": {
      "command": "npx",
      "args": ["-y", "@mesheshq/mcp-server"],
      "env": {
        "MESHES_ACCESS_KEY": "your_access_key",
        "MESHES_SECRET_KEY": "your_secret_key",
        "MESHES_ORG_ID": "your_organization_uuid"
      }
    }
  }
}

Claude Desktop

Open Claude Desktop → Settings → Developer → Edit Config:

{
  "mcpServers": {
    "meshes": {
      "command": "npx",
      "args": ["-y", "@mesheshq/mcp-server"],
      "env": {
        "MESHES_ACCESS_KEY": "your_access_key",
        "MESHES_SECRET_KEY": "your_secret_key",
        "MESHES_ORG_ID": "your_organization_uuid"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "meshes": {
      "command": "npx",
      "args": ["-y", "@mesheshq/mcp-server"],
      "env": {
        "MESHES_ACCESS_KEY": "your_access_key",
        "MESHES_SECRET_KEY": "your_secret_key",
        "MESHES_ORG_ID": "your_organization_uuid"
      }
    }
  }
}

Security note: MCP config files contain your secret key. They live in your home directory (e.g. ~/.cursor/mcp.json), not your project repo. Never commit access keys or secret keys to version control.

Environment Variables

Variable	Required	Description
MESHES_ACCESS_KEY	Yes	Machine access key from dashboard
MESHES_SECRET_KEY	Yes	Machine secret key from dashboard
MESHES_ORG_ID	Yes*	Organization UUID
MESHES_ORGANIZATION_ID	Yes*	Alias for MESHES_ORG_ID (SDK-compatible name)
MESHES_API_URL	No	API base URL (default: https://api.meshes.io)

* Set either MESHES_ORG_ID or MESHES_ORGANIZATION_ID.

Available Tools

Tool	Description
meshes_emit_event	Emit a product event to Meshes for routing and delivery
meshes_emit_bulk_events	Emit up to 100 events in a single request
meshes_list_workspaces	List all workspaces in the multi-tenant organization
meshes_get_workspace	Get details of a specific workspace
meshes_create_workspace	Create a new workspace
meshes_update_workspace	Update workspace properties
meshes_get_workspace_connections	List connections scoped to a workspace
meshes_get_workspace_event_types	List event types configured for a workspace
meshes_get_workspace_resources	List resources configured for a workspace
meshes_get_workspace_rules	List workspace rules with optional event/resource filters
meshes_list_connections	List connections across the organization
meshes_get_connection	Get details of a connection
meshes_create_connection	Create a new connection destination
meshes_update_connection	Update connection configuration metadata
meshes_delete_connection	Delete a connection
meshes_get_connection_actions	Get available actions (destination endpoints) for a connection
meshes_get_connection_fields	Get destination field configuration for mappings
meshes_get_connection_default_mappings	Get default mappings for a connection
meshes_update_connection_default_mappings	Update default mappings for a connection
meshes_list_rules	List all routing rules
meshes_get_rule	Get details of a specific routing rule
meshes_create_rule	Create an event routing rule mapping events to an action
meshes_delete_rule	Delete an event routing rule
meshes_list_events	List events across the organization with pagination
meshes_get_workspace_events	List events for a workspace with filtered criteria
meshes_get_event	Get event details with delivery status matrix
meshes_get_event_payload	Get event details containing data payload
meshes_retry_event_rule	Retry a failed rule delivery
meshes_list_integrations	Get metadata about all supported integration types
meshes_create_session	Mint a workspace, dashboard, or resource-scoped embed session
meshes_list_sessions	List embedded sessions for a workspace with optional filters
meshes_refresh_session	Refresh an existing session token
meshes_revoke_session	Revoke an embedded session

Development

git clone https://github.com/mesheshq/meshes-mcp-server.git
cd meshes-mcp-server
npm install
npm run build
npm test

What is Meshes?

Meshes is a universal integration layer for SaaS applications. Emit product events once — signups, payments, form submissions — and Meshes routes them to CRMs, email tools, webhooks, and more with retries, fan-out, field mappings, and multi-tenant isolation built in.

Documentation

• Meshes Docs
• API Reference
• MCP Server Docs
• Authentication

License

MIT