{"id":46055667,"url":"https://github.com/mesheshq/meshes-mcp-server","last_synced_at":"2026-05-05T06:08:08.695Z","repository":{"id":341333905,"uuid":"1169747203","full_name":"mesheshq/meshes-mcp-server","owner":"mesheshq","description":"MCP server for Meshes — emit events, manage workspaces, create rules, and inspect deliveries from any MCP-compatible client.","archived":false,"fork":false,"pushed_at":"2026-04-19T06:19:50.000Z","size":143,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-19T08:26:32.000Z","etag":null,"topics":["ai-tools","claude-code","cursor","event-routing","integrations","mcp","mcp-server","meshes","model-context-protocol","typescript","webhooks"],"latest_commit_sha":null,"homepage":"https://meshes.io","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mesheshq.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-01T06:24:17.000Z","updated_at":"2026-04-19T06:19:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mesheshq/meshes-mcp-server","commit_stats":null,"previous_names":["mesheshq/meshes-mcp-server"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/mesheshq/meshes-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mesheshq%2Fmeshes-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mesheshq%2Fmeshes-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mesheshq%2Fmeshes-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mesheshq%2Fmeshes-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mesheshq","download_url":"https://codeload.github.com/mesheshq/meshes-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mesheshq%2Fmeshes-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32636458,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-04T10:08:07.713Z","status":"online","status_checked_at":"2026-05-05T02:00:06.033Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","claude-code","cursor","event-routing","integrations","mcp","mcp-server","meshes","model-context-protocol","typescript","webhooks"],"created_at":"2026-03-01T10:01:25.280Z","updated_at":"2026-05-05T06:08:08.656Z","avatar_url":"https://github.com/mesheshq.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# @mesheshq/mcp-server\n\n[![Tests](https://github.com/mesheshq/meshes-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/mesheshq/meshes-mcp-server/actions/workflows/ci.yml)\n[![NPM Version][npm-version-image]][npm-url]\n[![NPM Install Size][npm-install-size-image]][npm-install-size-url]\n\nMCP server for [Meshes](https://meshes.io) — emit events, manage workspaces,\ncreate routing rules, and inspect deliveries from any MCP-compatible client.\n\n## Features\n\n- **Emit Events** — send product events (signups, payments, cancellations) to Meshes\n- **Manage Workspaces** — list and configure workspaces\n- **Workspace Discovery** — inspect available workspace event types and resources\n- **Routing Rules** — create and update event routing rules\n- **Connections** — manage integration connections (HubSpot, Salesforce, Slack, Mailchimp, etc.)\n- **Delivery Status** — inspect event delivery logs and retry status\n- **Embedded Sessions** — mint, list, refresh, and revoke workspace, dashboard, or resource-scoped sessions\n\n## Setup\n\nCreate a free Meshes account and create Machine Keys in the dashboard\nunder Profile → API Keys.\n\n### Claude Code\n\n```bash\nclaude mcp add meshes \\\n -e MESHES_ACCESS_KEY=your_access_key \\\n -e MESHES_SECRET_KEY=your_secret_key \\\n -e MESHES_ORG_ID=your_org_id \\\n -- npx -y @mesheshq/mcp-server\n```\n\n### Cursor\n\nOpen Cursor Settings → MCP → Add new global MCP server:\n\n```json\n{\n  \"mcpServers\": {\n    \"meshes\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@mesheshq/mcp-server\"],\n      \"env\": {\n        \"MESHES_ACCESS_KEY\": \"your_access_key\",\n        \"MESHES_SECRET_KEY\": \"your_secret_key\",\n        \"MESHES_ORG_ID\": \"your_organization_uuid\"\n      }\n    }\n  }\n}\n```\n\n### Claude Desktop\n\nOpen Claude Desktop → Settings → Developer → Edit Config:\n\n```json\n{\n  \"mcpServers\": {\n    \"meshes\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@mesheshq/mcp-server\"],\n      \"env\": {\n        \"MESHES_ACCESS_KEY\": \"your_access_key\",\n        \"MESHES_SECRET_KEY\": \"your_secret_key\",\n        \"MESHES_ORG_ID\": \"your_organization_uuid\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to your Windsurf MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"meshes\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@mesheshq/mcp-server\"],\n      \"env\": {\n        \"MESHES_ACCESS_KEY\": \"your_access_key\",\n        \"MESHES_SECRET_KEY\": \"your_secret_key\",\n        \"MESHES_ORG_ID\": \"your_organization_uuid\"\n      }\n    }\n  }\n}\n```\n\n\u003e **Security note:** MCP config files contain your secret key. They\n\u003e live in your home directory (e.g. `~/.cursor/mcp.json`), not your\n\u003e project repo. Never commit access keys or secret keys to version control.\n\n## Environment Variables\n\n| Variable                 | Required | Description                                     |\n| ------------------------ | -------- | ----------------------------------------------- |\n| `MESHES_ACCESS_KEY`      | Yes      | Machine access key from dashboard               |\n| `MESHES_SECRET_KEY`      | Yes      | Machine secret key from dashboard               |\n| `MESHES_ORG_ID`          | Yes\\*    | Organization UUID                               |\n| `MESHES_ORGANIZATION_ID` | Yes\\*    | Alias for `MESHES_ORG_ID` (SDK-compatible name) |\n| `MESHES_API_URL`         | No       | API base URL (default: `https://api.meshes.io`) |\n\n\\* Set either `MESHES_ORG_ID` or `MESHES_ORGANIZATION_ID`.\n\n## Available Tools\n\n| Tool                                     | Description                                                    |\n| ---------------------------------------- | -------------------------------------------------------------- |\n| `meshes_emit_event`                      | Emit a product event to Meshes for routing and delivery        |\n| `meshes_emit_bulk_events`                | Emit up to 100 events in a single request                      |\n| `meshes_list_workspaces`                 | List all workspaces in the multi-tenant organization           |\n| `meshes_get_workspace`                   | Get details of a specific workspace                            |\n| `meshes_create_workspace`                | Create a new workspace                                         |\n| `meshes_update_workspace`                | Update workspace properties                                    |\n| `meshes_get_workspace_connections`       | List connections scoped to a workspace                         |\n| `meshes_get_workspace_event_types`       | List event types configured for a workspace                    |\n| `meshes_get_workspace_resources`         | List resources configured for a workspace                      |\n| `meshes_get_workspace_rules`             | List workspace rules with optional event/resource filters      |\n| `meshes_list_connections`                | List connections across the organization                       |\n| `meshes_get_connection`                  | Get details of a connection                                    |\n| `meshes_create_connection`               | Create a new connection destination                            |\n| `meshes_update_connection`               | Update connection configuration metadata                       |\n| `meshes_delete_connection`               | Delete a connection                                            |\n| `meshes_get_connection_actions`          | Get available actions (destination endpoints) for a connection |\n| `meshes_get_connection_fields`           | Get destination field configuration for mappings               |\n| `meshes_get_connection_default_mappings` | Get default mappings for a connection                          |\n| `meshes_update_connection_default_mappings` | Update default mappings for a connection                    |\n| `meshes_list_rules`                      | List all routing rules                                         |\n| `meshes_get_rule`                        | Get details of a specific routing rule                         |\n| `meshes_create_rule`                     | Create an event routing rule mapping events to an action       |\n| `meshes_delete_rule`                     | Delete an event routing rule                                   |\n| `meshes_list_events`                     | List events across the organization with pagination            |\n| `meshes_get_workspace_events`            | List events for a workspace with filtered criteria             |\n| `meshes_get_event`                       | Get event details with delivery status matrix                  |\n| `meshes_get_event_payload`               | Get event details containing data payload                      |\n| `meshes_retry_event_rule`                | Retry a failed rule delivery                                   |\n| `meshes_list_integrations`               | Get metadata about all supported integration types             |\n| `meshes_create_session`                  | Mint a workspace, dashboard, or resource-scoped embed session  |\n| `meshes_list_sessions`                   | List embedded sessions for a workspace with optional filters   |\n| `meshes_refresh_session`                 | Refresh an existing session token                              |\n| `meshes_revoke_session`                  | Revoke an embedded session                                     |\n\n## Development\n\n```bash\ngit clone https://github.com/mesheshq/meshes-mcp-server.git\ncd meshes-mcp-server\nnpm install\nnpm run build\nnpm test\n```\n\n## What is Meshes?\n\n[Meshes](https://meshes.io) is a universal integration layer for SaaS\napplications. Emit product events once — signups, payments, form\nsubmissions — and Meshes routes them to CRMs, email tools, webhooks,\nand more with retries, fan-out, field mappings, and multi-tenant\nisolation built in.\n\n## Documentation\n\n- [Meshes Docs](https://meshes.io/docs)\n- [API Reference](https://docs.meshes.dev)\n- [MCP Server Docs](https://meshes.io/docs/ai/mcp-server)\n- [Authentication](https://meshes.io/docs/api/authentication)\n\n## License\n\nMIT\n\n[npm-install-size-image]: https://badgen.net/packagephobia/publish/@mesheshq/mcp-server?cache=200\n[npm-install-size-url]: https://packagephobia.com/result?p=%40mesheshq%2Fmcp-server\n[npm-url]: https://www.npmjs.com/package/@mesheshq/mcp-server\n[npm-version-image]: https://badgen.net/npm/v/@mesheshq/mcp-server?cache=200\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmesheshq%2Fmeshes-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmesheshq%2Fmeshes-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmesheshq%2Fmeshes-mcp-server/lists"}