Skip to main content

WAVE-MCP

Managed Wave Matrix/Synapse MCP for user and bot messaging, encrypted room operations, and Synapse admin workflows.

Authentication​

  • Header: Authorization

  • Format: Bearer mad_live_***

  • This service reference is generated from the active immutable Portal catalog.

Catalog Coverage​

  • Raw provider tools: 34
  • Exposed compatibility tools: 34
  • Agent-ready tools: 30
  • Documented descriptors: 34
  • Public reference pages: 34
  • Source repository: https://github.com/MADPANDA3D/WAVE-MCP
  • Catalog version: 2026-07-12.1
  • Catalog verified: 2026-07-12T10:04:40.362816+00:00 (5 days old)
  • Guide verified: not manually verified (not verified)
  • Committed snapshot: catalog-5ec40de147b11c40
  • Docs generated: 2026-07-18T00:19:58.776Z

Read-only Tools​

  • Admin Get Room — Fetch one Synapse room record. Requires an admin identity from server env or a verified primary Wave admin account.
  • Admin Get User — Fetch one Synapse user record. Requires an admin identity from server env or a verified primary Wave admin account.
  • Admin List Rooms — List Synapse rooms with pagination. Requires an admin identity from server env or a verified primary Wave admin account.
  • Admin List Users — List Synapse users with pagination. Requires an admin identity from server env or a verified primary Wave admin account.
  • Check Configuration — Use this first to verify Wave MCP portal, Matrix, bot, admin, user, and E2EE readiness without exposing secrets.
  • Check Wave Configuration — Use this grant-only local check before any provider call to learn whether an approved Wave identity is configured. It contacts neither Matrix nor Synapse and returns presence flags only, never credential values.
  • Crypto Status — Report E2EE client/session readiness for configured Wave identities without exposing keys.
  • Export Room History — Read one paginated page of Wave room history for ingestion workflows. Page with nextFrom; encrypted events include decrypted content or key-state errors.
  • Find Wave Tools — Use this grant-only local ranked search when you know the Wave task but not the tool name. It normalizes punctuation, requires every query term, defaults to agent-ready tools, and contacts neither Matrix nor Synapse.
  • Get Endpoint Coverage — Return the Matrix/Synapse endpoint coverage matrix or a focused section.
  • Get Room Messages — Read recent messages from a Wave room. Encrypted events are decrypted when the MCP Matrix device has keys.
  • Get Tool Usage — Explain when to use a Wave MCP tool, required parameters, side effects, and follow-up tools.
  • Get Wave Endpoint Coverage — Use this grant-only local reference to inspect filtered, paginated Matrix and Synapse endpoint coverage, implementation status, risk, and documentation without contacting the provider.
  • Get Wave Tool Usage — Use this grant-only local reference after discovery to resolve a Wave native name, canonical name, or alias to its complete input/output schemas, safety annotations, and exact confirmation contract.
  • List Capabilities — List Wave MCP capability groups, risk levels, actor requirements, and common workflows.
  • List Identities — List configured Wave identities available to this request without returning access tokens.
  • List Rooms — List joined Wave rooms for the selected user or bot actor.
  • List Wave Capabilities — Use this grant-only local catalog to inspect Wave capability groups and versioned counts. Set include_descriptors=true only for a lossless provider ToolManifest; it contacts neither Matrix nor Synapse.
  • Who Am I — Call Matrix whoami as the selected Wave actor. Requires explicit actor when more than one identity may be available.

Write and Destructive Tools​

  • Admin Create Or Update User — Create or update a Synapse user. Requires destructive confirmation because it can change account access.
  • Admin Deactivate User — Deactivate and optionally erase a Synapse user. Requires destructive confirmation.
  • Admin Purge Room — Purge a room from Synapse after shutdown/deletion. Requires destructive confirmation.
  • Admin Purge Room History — Purge historical events from a Synapse room. Requires destructive confirmation.
  • Admin Registration Tokens — List, create, or delete Synapse registration tokens for Wave invite links.
  • Admin Reset Password — Reset a Synapse user's password. Requires destructive confirmation.
  • Admin Shutdown Room — Delete/shutdown a Synapse room with optional block and purge behavior. Requires destructive confirmation.
  • Broadcast Message — Send the same message to multiple Wave rooms. Defaults to dry-run and requires broadcast confirmation to send.
  • Create Room — Create a Wave room as the selected user or bot, optionally encrypted by default.
  • Invite User — Invite a Matrix user to a Wave room as the selected user or bot.
  • Join Room — Join a Wave room by ID or alias as the selected user or bot.
  • Leave Room — Leave a Wave room as the selected user or bot.
  • React To Event — Send a Matrix reaction to a message event as the selected user or bot.
  • Redact Event — Redact a Matrix event as the selected user or bot. Requires destructive confirmation.
  • Send Message — Send a message to a Wave room as the selected user or bot. In encrypted rooms the SDK encrypts before sending.