Magnet MCP Server
# Magnet MCP Server
An MCP server for interacting with Magnet (magnet.run)
> **Note:** Currently macOS only. Windows and Linux support coming soon.
## Setup
To set it up:
1. Generate an API key for your Workspace (Organization) at
[https://www.magnet.run/settings](https://www.magnet.run/settings) or from the Settings -> MCP section of the Desktop app.
2. Set up your MCP server configuration:
**For Cursor or Claude Desktop** (add to your MCP settings JSON):
```json
{
"Magnet": {
"command": "npx",
"args": [
"-y",
"@magnet-ai/magnet-mcp-server"
],
"env": {
"MAGNET_API_KEY": "your-api-key-here"
}
}
}
```
**For Claude Code** (run this command):
```bash
claude mcp add --transport stdio Magnet --env MAGNET_API_KEY=your-api-key-here -- npx -y @magnet-ai/magnet-mcp-server
```
### 💡 TIP:
If you are seeing issues getting your MCP server configuration working, consider that it might be an issue with the node / npx version, and try to put a full path to the npx you would like to use in the `"command"` field.
## Local Development
For instructions on developing and testing locally, see [LOCAL_DEVELOPMENT.md](LOCAL_DEVELOPMENT.md).
TDQS
Scored across 10 tools
Each tool targets a distinct combination of resource (issue, page, chat) and action (get, list, create, update, upload, search). There is no ambiguity between tools, as issues and pages are clearly separate entities.
All tool names follow a consistent verb_noun pattern using snake_case (e.g., get_issue_by_id, list_issues, create_page, update_page, upload_chat, search). This consistency aids in predictable tool selection.
With 10 tools covering CRUD operations for two resources plus additional upload and search capabilities, the count is well-scoped for a documentation/issue tracking server.
The tool set covers create, read, update, and list operations for both issues and pages, along with search and chat upload. The only notable gap is the absence of delete operations for issues and pages, which may be intentional but leaves a minor incompleteness.