{"_id":"@appsignal/mcp","_rev":"7-1015928b35e9af1460e151e51303f252","name":"@appsignal/mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@appsignal/mcp","version":"1.0.0","keywords":["appsignal","mcp","server"],"author":{"name":"AppSignal"},"license":"MIT","_id":"@appsignal/mcp@1.0.0","maintainers":[{"name":"matsimitsu","email":"robert@appsignal.com"},{"name":"wesoudshoorn","email":"wes@appsignal.com"},{"name":"jvanbaarsen","email":"jeroenvanbaarsen@gmail.com"},{"name":"thijsc","email":"thijs@appsignal.com"},{"name":"tombruijn","email":"tom@tomdebruijn.com"},{"name":"jkreeftmeijer","email":"npm@kreeft.me"},{"name":"as_unflxw","email":"noemi@appsignal.com"}],"homepage":"https://appsignal.com","bugs":{"url":"https://github.com/appsignal/mcp/issues"},"bin":{"appsignal-server":"build/index.js"},"dist":{"shasum":"0519c5673b9873ca3f3414a0eec583109ba23481","tarball":"https://registry.npmjs.org/@appsignal/mcp/-/mcp-1.0.0.tgz","fileCount":4,"integrity":"sha512-s+K+Oz636h67ys8C5IhnzRVhugQZ6CLjGorWDi8dw92hAeh3r8CIPpplHuIpMbGi7qy/KBnMfJ64Q8/DDPgkFQ==","signatures":[{"sig":"MEQCIB42Jl5wsl40XQ8NhAB5JG+BCdsYCBLUBixO7GcR1xEoAiAtXw/PyIIne22jjAJ2uktga+ATb2ZcSlEMk/c9ddCSFg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9850},"main":"index.js","type":"module","gitHead":"211ee86006da342748464dc162a9b74c0257fd98","scripts":{"test":"jest","build":"tsc","watch":"tsc --watch","prepare":"npm run build","inspector":"npx @modelcontextprotocol/inspector build/index.js","test:watch":"jest --watch"},"_npmUser":{"name":"tombruijn","email":"tom@tomdebruijn.com"},"repository":{"url":"git+https://github.com/appsignal/mcp.git","type":"git"},"_npmVersion":"11.5.1","description":"The official AppSignal MCP server","directories":{},"_nodeVersion":"24.5.0","dependencies":{"axios":"^1.11.0","dotenv":"^17.2.1","@modelcontextprotocol/sdk":"^1.17.4"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","ts-jest":"^29.4.1","typescript":"^5.9.2","@types/jest":"^29.5.11","@types/node":"^24.3.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.0_1760013359364_0.5077315314855977","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-10-09T12:35:59.362Z","modified":"2026-09-10T10:18:11.573Z","1.0.0":"2025-10-09T12:35:59.550Z"},"bugs":{"url":"https://github.com/appsignal/mcp/issues"},"author":{"name":"AppSignal"},"license":"MIT","homepage":"https://appsignal.com","keywords":["appsignal","mcp","server"],"repository":{"url":"git+https://github.com/appsignal/mcp.git","type":"git"},"description":"The official AppSignal MCP server","maintainers":[{"email":"robert@appsignal.com","name":"matsimitsu"},{"email":"jeroenvanbaarsen@gmail.com","name":"jvanbaarsen"},{"email":"thijs@appsignal.com","name":"thijsc"},{"email":"tom@tomdebruijn.com","name":"tombruijn"},{"email":"noemi@appsignal.com","name":"as_unflxw"},{"email":"brunjact@protonmail.com","name":"brunjact"},{"email":"anton@appsignal.com","name":"anton.kalinin"},{"email":"martin@appsignal.com","name":"martinlipskis"}],"readme":"# AppSignal MCP Server [beta]\n\nThis is the official AppSignal [MCP][mcp] server. It allows AI agents to access AppSignal's monitoring data, metrics, and tools and is currently in beta.\n\nJoin our [Discord community][discord] to help test and shape this MCP implementation.\n\n## Prerequisites\n\n- Docker\n- An [AppSignal account][appsignal-sign-up] and an [AppSignal MCP token][appsignal-mcp-token].\n\n## Installation\n\nPull the Docker image:\n\n```\ndocker pull appsignal/mcp:latest\n```\n\n## Configuration\n\n### Claude\n\nConfigure Claude to use the AppSignal MCP server by editing the `~/Library/Application Support/Claude/claude_desktop_config.json` file:\n\n```json\n{\n  \"mcpServers\": {\n    \"appsignal\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"-i\", \"--rm\", \"-e\", \"APPSIGNAL_API_KEY\", \"appsignal/mcp\"],\n      \"env\": {\n        \"APPSIGNAL_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Claude code\n\nTo enable AppSignal MCP in Claude Code, run the following command:\n\n```\nclaude mcp add appsignal -e APPSIGNAL_API_KEY=your_api_key_here -- docker run -i --rm -e APPSIGNAL_API_KEY appsignal/mcp\n```\n\n### Cursor and Windsurf\n\nTo enable AppSignal MCP in Cursor or Windsurf, edit your configuration file.\n\nFor Cursor use `~/.cursor/mcp.json`\n\nFor Windsurf use `~/.codeium/windsurf/mcp_config.json`\n\nAdd the following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"appsignal\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"-i\", \"--rm\", \"-e\", \"APPSIGNAL_API_KEY\", \"appsignal/mcp\"],\n      \"env\": {\n        \"APPSIGNAL_API_KEY\": \"your-mcp-token\"\n      }\n    }\n  }\n}\n```\n\n### Zed\n\nOpen your Zed settings file and add the `context_servers` section:\n\n```json\n{\n  \"context_servers\": {\n    \"appsignal\": {\n      \"source\": \"custom\",\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"-i\", \"--rm\", \"-e\", \"APPSIGNAL_API_KEY\", \"appsignal/mcp\"],\n      \"env\": {\n        \"APPSIGNAL_API_KEY\": \"your-mcp-token\"\n      }\n    }\n}\n```\n\n### VSCode\n\nIf you are running GitHub Copilot, and are signed in under a company account, make sure to set \"MCP servers in Copilot\" to \"Enabled\" under your organization settings > Copilot > Policies.\n\n![GitHub Copilot Settings](public/assets/images/github-copilot-settings.png)\n\nThen add this config to your `.vscode/mcp.json` settings:\n\n```json\n{\n  \"inputs\": [\n    {\n      \"type\": \"promptString\",\n      \"id\": \"appsignal_mcp_token\",\n      \"description\": \"AppSignal MCP Token\",\n      \"password\": true\n    }\n  ],\n  \"servers\": {\n    \"appsignal\": {\n      \"command\":  \"docker\"\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-e\",\n        \"APPSIGNAL_API_KEY\",\n        \"appsignal/mcp\"\n      ],\n      \"env\": {\n        \"APPSIGNAL_API_KEY\": \"${input:appsignal_mcp_token}\"\n      }\n    }\n  }\n}\n```\n\n## Development\n\nTo work on the MCP server:\n\n1. Start the TypeScript compiler in watch mode:\n\n   ```bash\n   npm run watch\n   ```\n\n2. Run tests:\n\n   ```bash\n   npm test\n   ```\n\n3. Use the MCP inspector for debugging:\n   ```bash\n   npm run inspector\n   ```\n\n### Change management\n\nEvery change that will results in a new version to be released, requires a changeset.\nChangesets are small Markdown file that describe the change for the end-user.\nThe changeset's frontmatter describes the type of change (new feature, bug fix, etc.) and the version bump (major, minor, or patch).\n\nUse [Mono's changeset CLI](https://github.com/appsignal/mono/?tab=readme-ov-file#changeset-add) to generate a new changeset file.\nCommit the changeset file and include it in your Pull Requests.\n\n```\nmono changeset add\n```\n\n### Publishing\n\nInstall [Mono](https://github.com/appsignal/mono/), the tool used for release management.\n\n```\ngit pull # Ensure you have the latest version\n\nmono publish # Publish a new version\n```\n\n## Contributing\n\nThinking of contributing to our project? Awesome! 🚀\n\nPlease follow our [Contributing guide][contributing-guide] in our\ndocumentation and follow our [Code of Conduct][coc].\n\nAlso, we would be very happy to send you Stroopwafles. Have look at everyone\nwe send a package to so far on our [Stroopwafles page][waffles-page].\n\n## Support\n\n- Join our [Discord community][discord] to chat with other developers and the AppSignal team\n- [Contact us][contact] to speak directly with the engineers working on AppSignal. They will help you get set up, tweak your code and make sure you get the most out of using AppSignal.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## About AppSignal\n\n[AppSignal][appsignal] provides real-time performance monitoring for your web applications. Track errors, monitor performance, measure client-side metrics, and receive alerts when things go wrong.\n\n[mcp]: https://github.com/anthropics/anthropic-tools/blob/main/model-context-protocol.md\n[appsignal]: https://www.appsignal.com\n[appsignal-sign-up]: https://appsignal.com/users/sign_up\n[appsignal-mcp-token]: https://appsignal.com/users/mcp_tokens\n[contact]: mailto:support@appsignal.com\n[coc]: https://docs.appsignal.com/appsignal/code-of-conduct.html\n[waffles-page]: https://www.appsignal.com/waffles\n[contributing-guide]: https://docs.appsignal.com/appsignal/contributing.html\n[discord]: https://discord.gg/fT2cbMuQSJ\n","readmeFilename":"README.md"}