{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_2aaxyyx8phm9","handle":"mcp-server-matrix","url":"https://wellknown.network/agents/mcp-server-matrix","links":{"self":"https://wellknown.network/agents/mcp-server-matrix/record.json","html":"https://wellknown.network/agents/mcp-server-matrix","markdown":"https://wellknown.network/agents/mcp-server-matrix/record.md","api":"https://wellknown.network/api/v1/agents/mcp-server-matrix","status":"https://wellknown.network/api/v1/agents/mcp-server-matrix/status","claim":"https://wellknown.network/agents/mcp-server-matrix/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-server-matrix/claim.json","badge":"https://wellknown.network/agents/mcp-server-matrix/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-server-matrix/history","tools":"https://wellknown.network/api/v1/agents/mcp-server-matrix/tools"},"ard":{"identifier":"urn:air::server:mcp-server-matrix","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-server-matrix","summary":"MCP server for Matrix — interact with Matrix homeservers via Model Context Protocol","description":"# mcp-server-matrix\n\n[![README на русском](https://img.shields.io/badge/README-на_русском-blue)](README.ru.md)\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for [Matrix](https://matrix.org) — the open, decentralized communication protocol.\n\nBuilt on [matrix-nio](https://github.com/matrix-nio/matrix-nio), this server lets any MCP-compatible AI assistant (Claude, OpenClaw, etc.) send and read messages, manage rooms, and interact with any Matrix homeserver (Synapse, Dendrite, Conduit).\n\n## Features\n\n| Tool | Description |\n|------|-------------|\n| `send_message` | Send a message (text, HTML, or Markdown) with optional reply |\n| `read_messages` | Read recent messages (with pagination) |\n| `get_messages_by_date` | Get messages filtered by date range |\n| `list_rooms` | List all joined rooms |\n| `get_room_info` | Room details — name, topic, members, encryption status |\n| `get_room_members` | List joined members with display names and avatars |\n| `get_notification_counts` | Unread and mention counts per room |\n| `get_direct_messages` | List DM conversations with unread status |\n| `send_direct_message` | Send a DM (auto-creates room if needed) |\n| `get_user_profile` | User profile — display name, avatar |\n| `join_room` | Join a room by ID or alias |\n| `leave_room` | Leave a room |\n| `create_room` | Create a new room (with optional invites) |\n| `invite_user` | Invite a user to a room |\n| `send_reaction` | React to a message with an emoji |\n| `resolve_alias` | Resolve `#alias:server` to a room ID |\n\n## Installation\n\n```bash\npip install mcp-server-matrix\n```\n\nOr with [uv](https://docs.astral.sh/uv/):\n\n```bash\nuvx mcp-server-matrix\n```\n\n## Configuration\n\nSet environment variables:\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `MATRIX_HOMESERVER` | Yes | Homeserver URL (e.g. `https://matrix.org`) |\n| `MATRIX_USER` | Yes | Full user ID (e.g. `@bot:matrix.org`) |\n| `MATRIX_PASSWORD` | Yes* | Account password |\n| `MATRIX_A…","publisher":null,"homepage":"https://github.com/Baho73/mcp-server-matrix","repository":"https://github.com/Baho73/mcp-server-matrix","version":"0.2.0","license":"MIT","protocols":["mcp"],"tags":["chat","element","matrix","matrix-nio","mcp","model-context-protocol","synapse"],"pricing":null,"endpoints":[{"url":"pypi:mcp-server-matrix","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"communication.chat","name":"Team Chat","confidence":1,"provenance":"declared"}],"categories":["communication"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-server-matrix","registry":"pypi","observedAt":"2026-11-03T15:23:25.324Z","publishedAt":"2026-04-03T22:31:30.026678Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-server-matrix","url":"https://pypi.org/project/mcp-server-matrix/","firstSeenAt":"2026-09-10T04:21:45.814Z","fetchedAt":"2026-11-03T15:22:51.164Z","normalizedAt":"2026-11-03T15:22:51.164Z"}]},"firstSeenAt":"2026-09-10T04:21:45.814Z","updatedAt":"2026-11-03T15:23:25.324Z"}