arcade-matter-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MATTER_API_TOKEN | Yes | Your Matter API token, generated at web.getmatter.com/settings. Needs Matter Pro. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tasks | {
"list": {},
"cancel": {},
"requests": {
"tools": {
"call": {}
}
}
} |
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| Matter_AddTagA | Tag an item by tag name, creating the tag if it doesn't exist yet. |
| Matter_DeleteHighlightA | Permanently delete a highlight and its note. This can't be undone. |
| Matter_DeleteItemA | Permanently delete an item from the user's Matter library, along with its highlights. Its tags are only removed from this item; the tags themselves are kept (use DeleteTag to delete a tag). This can't be undone; to keep it out of the queue, archive it with UpdateItem instead. |
| Matter_DeleteTagA | Permanently delete a tag and remove it from every item. The items are kept. This can't be undone; to untag a single item, use RemoveTag instead. |
| Matter_GetAccountA | Get the Matter account the server is connected to, including its API rate limits (requests per minute for reads, writes, saves, searches and full-text fetches) and how many read requests are left in the current window. |
| Matter_GetItemA | Get a single item's metadata by ID. Use GetItemContent for the full text. |
| Matter_GetItemContentA | Get an item's full text as Markdown, in chunks of up to max_chars. Matter allows only 20 full-text fetches per minute, so use excerpts from ListItems or GetItem when they're enough. |
| Matter_GetItemWithHighlightsA | Get an item together with every highlight and note on it (up to 100), in two requests. Use this to answer "what did I highlight in this article?". |
| Matter_ListHighlightsB | List the passages the user highlighted in one item, with any notes they added. |
| Matter_ListItemsA | List items in the user's Matter library, filtered by status, favorites, tags or content type. Use SearchLibrary to find items by words in their text, title, author or site. |
| Matter_ListReadingSessionsB | List the user's reading sessions, newest first. Each session is one period of reading with its start time and duration in seconds; a day can have several. |
| Matter_ListRecentHighlightsA | List the highlights the user made recently, grouped by item. Use this to answer "what did I highlight this week?". Makes one request for recently updated items and one per item checked (at most 21 requests). Reading progress and tag changes also count as updates, so when more_items is set, some highlighted items may not have been checked. |
| Matter_ListTagsB | List the user's Matter tags with how many items each one is on. |
| Matter_RemoveTagA | Remove a tag from one item. The tag itself and its other items are kept. |
| Matter_RenameTagB | Rename a tag everywhere it's used. |
| Matter_SaveItemA | Save a URL to the user's Matter library. Matter extracts the content in the background, usually within a minute; check GetItem later if processing_status is 'processing'. If the URL is already saved, the existing item is returned unchanged with already_in_library: true; use UpdateItem to move it. |
| Matter_SearchLibraryA | Search the user's Matter library by full text, title, author or site, ranked by relevance. Results marked in_library: false aren't saved, so item tools can't use them. |
| Matter_SetHighlightNoteA | Add, replace or remove the note on a highlight. Matter's API can't create highlights. |
| Matter_SummarizeReadingTimeA | Summarize how much the user read over a period: total and average minutes, days read, the longest streak, the busiest day, and the current streak when the period reaches yesterday or today. Use this to answer "how much have I read this month?" or "how much did I read in September?". Makes up to 10 requests. |
| Matter_UpdateItemA | Archive or re-queue an item, favorite or unfavorite it, or set its reading progress. Pass at least one change. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 20 tools
Most tools target distinct resource+action pairs (tags, items, highlights, sessions). However, ListHighlights, ListRecentHighlights, and GetItemWithHighlights all return highlights and could be confused, though descriptions clarify per-item vs cross-item scope. GetItem vs GetItemContent vs GetItemWithHighlights are also close but distinguishably described.
Every tool uses the Matter_ prefix with a consistent PascalCase verb_noun pattern (GetItem, ListTags, AddTag, RemoveTag, DeleteItem, SearchLibrary). No mixing of conventions.
20 tools is on the heavier side but justified by a genuinely multi-resource domain (items, highlights, tags, sessions, account, summaries). Each tool earns its place with minimal redundancy.
Covers full lifecycle for tags (add/remove/rename/delete/list) and strong coverage for items and highlights, plus search, sessions, account, and reading stats. Highlight creation is absent, but that is an explicit upstream API limitation rather than a design gap.