{"_id":"superops-msp","_rev":"40-139eff05bffaba0d94b1c9eade56cd31","name":"superops-msp","dist-tags":{"latest":"2.0.0"},"versions":{"1.0.0":{"name":"superops-msp","version":"1.0.0","keywords":["mcp","superops","msp","graphql","api","claude","ai"],"author":{"name":"Limehawk"},"license":"MIT","_id":"superops-msp@1.0.0","maintainers":[{"name":"limehawk","email":"cw@limehawk.io"}],"homepage":"https://github.com/Limehawk/superops-mcp/tree/main/packages/msp#readme","bugs":{"url":"https://github.com/Limehawk/superops-mcp/issues"},"bin":{"superops-msp":"src/index.mjs"},"dist":{"shasum":"d0948ef5f605af9689e112e0ecadbeacd3b4b146","tarball":"https://registry.npmjs.org/superops-msp/-/superops-msp-1.0.0.tgz","fileCount":5,"integrity":"sha512-8y1c0K6AVhOxBsEz9LPox8dPphirLolRj+aIdndL84T14JkB0fjaAU5QQboFwR3Ks+bPCEldWO2TBR0YkWGA5Q==","signatures":[{"sig":"MEQCICmpAwrQ3sc37tleZjJPWjiFqmL/4f43fuUAftVpDy6LAiBUHmKKw7puXjl3SkRq8XFtk7mvza0RvpNXUpabthN4Dw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":451403},"main":"src/index.mjs","type":"module","gitHead":"64d70e44b45e85be7d34165a07295ed618222cf5","scripts":{"start":"node src/index.mjs"},"_npmUser":{"name":"limehawk","email":"cw@limehawk.io"},"deprecated":"Outdated - please upgrade to latest version","repository":{"url":"git+https://github.com/Limehawk/superops-mcp.git","type":"git","directory":"packages/msp"},"_npmVersion":"11.6.2","description":"MCP server for SuperOps MSP GraphQL API documentation","directories":{},"_nodeVersion":"25.2.1","dependencies":{"@modelcontextprotocol/sdk":"^1.25.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/superops-msp_1.0.0_1768341566123_0.4341018339113554","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"superops-msp","version":"1.0.1","keywords":["mcp","superops","msp","graphql","api","claude","ai"],"author":{"name":"Limehawk"},"license":"MIT","_id":"superops-msp@1.0.1","maintainers":[{"name":"limehawk","email":"cw@limehawk.io"}],"homepage":"https://github.com/Limehawk/superops-mcp/tree/main/packages/msp#readme","bugs":{"url":"https://github.com/Limehawk/superops-mcp/issues"},"bin":{"superops-msp":"src/index.mjs"},"dist":{"shasum":"91f0433946fbc628f9a748a3e4e87b23e1d1276a","tarball":"https://registry.npmjs.org/superops-msp/-/superops-msp-1.0.1.tgz","fileCount":5,"integrity":"sha512-e+ioelGt+fY41G4FEjKILMGajEQzubfdQcEe2QX3CmwJQv4Dghhq2TrggxmSUTjMNhJrnGSYiBL61iOdRDhV4w==","signatures":[{"sig":"MEQCIGpaJPNDXE6O+cdKl4zRiwiuL99E03q78b30XQj/RlZ9AiB9I1Qfgt1RDyKZJ/9AsLRTstNTKhBp489m7S/5wkFQtg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":451536},"main":"src/index.mjs","type":"module","gitHead":"b2ec8fe4cd4bf5b8148a9e11bc786bd9cf5ef389","scripts":{"start":"node src/index.mjs"},"_npmUser":{"name":"limehawk","email":"cw@limehawk.io"},"deprecated":"Outdated - please upgrade to latest version","repository":{"url":"git+https://github.com/Limehawk/superops-mcp.git","type":"git","directory":"packages/msp"},"_npmVersion":"11.6.2","description":"MCP server for SuperOps MSP GraphQL API documentation","directories":{},"_nodeVersion":"25.2.1","dependencies":{"@modelcontextprotocol/sdk":"^1.25.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/superops-msp_1.0.1_1768341687862_0.48933881991710315","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"superops-msp","version":"1.0.6","keywords":["mcp","superops","msp","graphql","api","claude","ai"],"author":{"name":"Limehawk"},"license":"MIT","_id":"superops-msp@1.0.6","maintainers":[{"name":"limehawk","email":"cw@limehawk.io"}],"homepage":"https://github.com/limehawk/superops-mcp/tree/main/packages/msp#readme","bugs":{"url":"https://github.com/limehawk/superops-mcp/issues"},"bin":{"superops-msp":"src/index.mjs"},"dist":{"shasum":"2a2937716a125fc063069399484d650c6572b6f7","tarball":"https://registry.npmjs.org/superops-msp/-/superops-msp-1.0.6.tgz","fileCount":5,"integrity":"sha512-iF6mU5CRuPHVtQ10h5HwmvLFp6LxuiYjebC5ICtUMish9dP6FrJpCXrMHZa4qzDNkexTuinrzBesG38ki06O5Q==","signatures":[{"sig":"MEUCIGsL6FzbmwHnuRHHjR9MG8683wip4s26NQVb8V5mmUHBAiEAy1bMmpzXVWzEVlAjVPmJ4M3J7la35PKPWlm69ib/Kf8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/superops-msp@1.0.6","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":451470},"main":"src/index.mjs","type":"module","gitHead":"cb69e5dd0c8d8a26381bd536d8a3cf25ed7186bf","scripts":{"start":"node src/index.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:645f655a-76d2-4b23-a6b7-c160edb37ced"}},"deprecated":"Outdated - please upgrade to latest version","repository":{"url":"git+https://github.com/limehawk/superops-mcp.git","type":"git","directory":"packages/msp"},"_npmVersion":"11.7.0","description":"MCP server for SuperOps MSP GraphQL API documentation","directories":{},"_nodeVersion":"22.21.1","dependencies":{"@modelcontextprotocol/sdk":"^1.25.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/superops-msp_1.0.6_1768343103047_0.5139425209603179","host":"s3://npm-registry-packages-npm-production"}},"1.1.14":{"name":"superops-msp","version":"1.1.14","keywords":["mcp","superops","msp","graphql","api","claude","ai"],"author":{"name":"Limehawk"},"license":"MIT","_id":"superops-msp@1.1.14","maintainers":[{"name":"limehawk","email":"cw@limehawk.io"}],"homepage":"https://github.com/limehawk/superops-mcp/tree/main/packages/msp#readme","bugs":{"url":"https://github.com/limehawk/superops-mcp/issues"},"bin":{"superops-msp":"src/index.mjs"},"dist":{"shasum":"080dd13719c5b1b685e2ac8ee88c07c3a78cfb4e","tarball":"https://registry.npmjs.org/superops-msp/-/superops-msp-1.1.14.tgz","fileCount":5,"integrity":"sha512-iWHO6cbi4K6Ll64E5uNX/KxdjlfA868ZiSClRs9Azn6GKn6SlJpoou2ZEe3L/vC1Xxg5fb7/W+n4GJ2k23lZfQ==","signatures":[{"sig":"MEUCIBQ0yKClPvPPlqJGRH+kNyfThYJCe0VpHNGJRzY3CENIAiEA+vTRWXsAD+F6NPV+0LBLK5Pe9jw0x8V9rkqz3wABLYs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/superops-msp@1.1.14","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":460739},"main":"src/index.mjs","type":"module","gitHead":"83a4fe58ca21cb9639d23a1e58e6f73560167e5d","scripts":{"start":"node src/index.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:787cc493-56c9-4eb0-9e13-746f2b3f9ab8"}},"deprecated":"Outdated - please upgrade to latest version","repository":{"url":"git+https://github.com/limehawk/superops-mcp.git","type":"git","directory":"packages/msp"},"_npmVersion":"11.7.0","description":"MCP server for SuperOps MSP GraphQL API documentation","directories":{},"_nodeVersion":"22.21.1","dependencies":{"@modelcontextprotocol/sdk":"^1.25.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/superops-msp_1.1.14_1768549401843_0.28752340755279904","host":"s3://npm-registry-packages-npm-production"}},"1.1.16":{"name":"superops-msp","version":"1.1.16","keywords":["mcp","superops","msp","graphql","api","claude","ai"],"author":{"name":"Limehawk"},"license":"MIT","_id":"superops-msp@1.1.16","maintainers":[{"name":"limehawk","email":"cw@limehawk.io"}],"homepage":"https://github.com/limehawk/superops-mcp/tree/main/packages/msp#readme","bugs":{"url":"https://github.com/limehawk/superops-mcp/issues"},"bin":{"superops-msp":"src/index.mjs"},"dist":{"shasum":"a442205c9334ea1aaade6cca91a2ff6433f87def","tarball":"https://registry.npmjs.org/superops-msp/-/superops-msp-1.1.16.tgz","fileCount":5,"integrity":"sha512-gnG2b3IK+kMsJUT/Sr6RWg4URKRoUUP9zGj7sKsDRKBqmrsPXmMiBi/Rw8C0If23E0LTIyOEvI0ql3LTixL/rQ==","signatures":[{"sig":"MEYCIQDztXHmdSVs2wv14NdAccT0kFlhyDXJFccs2U0XFNbaFAIhAIeTQMPe6ysWgYUExYH4ATILTprgMSAx9CIkqADDEBso","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/superops-msp@1.1.16","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":461537},"main":"src/index.mjs","type":"module","gitHead":"738aec564e5435181752c21d6c99e85e6fd71cfe","scripts":{"start":"node src/index.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:787cc493-56c9-4eb0-9e13-746f2b3f9ab8"}},"deprecated":"Outdated - please upgrade to latest version","repository":{"url":"git+https://github.com/limehawk/superops-mcp.git","type":"git","directory":"packages/msp"},"_npmVersion":"11.7.0","description":"MCP server for SuperOps MSP GraphQL API documentation","directories":{},"_nodeVersion":"24.12.0","dependencies":{"@modelcontextprotocol/sdk":"^1.25.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/superops-msp_1.1.16_1768857086326_0.9958708250286277","host":"s3://npm-registry-packages-npm-production"}},"1.1.18":{"name":"superops-msp","version":"1.1.18","keywords":["mcp","superops","msp","graphql","api","claude","ai"],"author":{"name":"Limehawk"},"license":"GPL-3.0","_id":"superops-msp@1.1.18","maintainers":[{"name":"limehawk","email":"cw@limehawk.io"}],"homepage":"https://github.com/limehawk/superops-mcp/tree/main/packages/msp#readme","bugs":{"url":"https://github.com/limehawk/superops-mcp/issues"},"bin":{"superops-msp":"src/index.mjs"},"dist":{"shasum":"b365b43b1cfa6b5afe4d7aeaa055bb24057458b1","tarball":"https://registry.npmjs.org/superops-msp/-/superops-msp-1.1.18.tgz","fileCount":11,"integrity":"sha512-8ZhGPowWrzoFbbVOutww3cvgib1giEZv9fUHNHVjUdt3IksE8JqxAvSlvpANtN//vqpP/avFymGJf/MY5+e7JA==","signatures":[{"sig":"MEUCIFRgFNndHDek55z/X2pwY0ph1m+gS9bof7LrLiKaafnxAiEA/e4MkqCRQ19tDc7rk6eUo6Cbhk9/gVCRqguGgD3LZ88=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":613933},"main":"src/index.mjs","type":"module","gitHead":"cd9d2b13b150f155fd3b9306a4633a4243f8966a","scripts":{"start":"node src/index.mjs"},"_npmUser":{"name":"limehawk","email":"cw@limehawk.io"},"repository":{"url":"git+https://github.com/limehawk/superops-mcp.git","type":"git","directory":"packages/msp"},"_npmVersion":"11.6.2","description":"MCP server for SuperOps MSP GraphQL API documentation","directories":{},"_nodeVersion":"25.2.1","dependencies":{"@modelcontextprotocol/sdk":"^1.25.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/superops-msp_1.1.18_1769719271377_0.3640160616750232","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."},"2.0.0":{"name":"superops-msp","version":"2.0.0","keywords":["mcp","superops","msp","graphql","api","claude","ai"],"author":{"name":"Limehawk"},"license":"MIT","_id":"superops-msp@2.0.0","maintainers":[{"name":"limehawk","email":"cw@limehawk.io"}],"homepage":"https://github.com/limehawk/superops-mcp/tree/main/packages/msp#readme","bugs":{"url":"https://github.com/limehawk/superops-mcp/issues"},"bin":{"superops-msp":"build/index.js"},"dist":{"shasum":"f751a7bc7bf4c6e4fc92a65b1d3d0f6d2056029a","tarball":"https://registry.npmjs.org/superops-msp/-/superops-msp-2.0.0.tgz","fileCount":15,"integrity":"sha512-OfKA0nMWU37vRSaD69a56V7RvhAZG3HmsfyuOANfh26nMsjxgAndgEmiaAEz/I6b3crN8Uc8DvSHViBMrsHi/Q==","signatures":[{"sig":"MEUCIGWwwvTZGau8uTTGuZ2t1I8GZcPXlC+i4B3ukIgyyRw2AiEAz4enm2epEP6rMmChEAhBONfjsl/mZadtHmcwff/3jAE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/superops-msp@2.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":50790},"main":"build/index.js","type":"module","gitHead":"479df13c8f85f6e6b17f01ba18d84a88da9a0aeb","scripts":{"dev":"tsc --watch","build":"rm -rf build && tsc && cp src/examples.json build/ && chmod 755 build/index.js","start":"node build/index.js","start:sse":"node build/index.js --sse","start:http":"node build/index.js --http","type-check":"tsc --noEmit"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:787cc493-56c9-4eb0-9e13-746f2b3f9ab8"}},"repository":{"url":"git+https://github.com/limehawk/superops-mcp.git","type":"git","directory":"packages/msp"},"_npmVersion":"11.11.1","description":"MCP server for SuperOps MSP API — 2-tool pattern with live GraphQL introspection","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"4","express":"^5.1.0","@modelcontextprotocol/sdk":"1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.15.0","@types/express":"^5.0.2"},"_npmOperationalInternal":{"tmp":"tmp/superops-msp_2.0.0_1773775337634_0.1970722576365418","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."}},"time":{"created":"2026-01-13T21:59:26.007Z","modified":"2026-05-05T16:44:21.396Z","1.0.0":"2026-01-13T21:59:26.282Z","1.0.1":"2026-01-13T22:01:28.012Z","1.0.6":"2026-01-13T22:25:03.197Z","1.0.7":"2026-01-15T10:39:03.460Z","1.1.0":"2026-01-15T13:35:05.004Z","1.1.1":"2026-01-15T13:46:25.618Z","1.1.2":"2026-01-15T15:27:23.595Z","1.1.5":"2026-01-16T06:12:40.507Z","1.1.6":"2026-01-16T06:37:12.276Z","1.1.8":"2026-01-16T07:11:27.393Z","1.1.9":"2026-01-16T07:13:38.316Z","1.1.10":"2026-01-16T07:14:59.352Z","1.1.11":"2026-01-16T07:27:59.463Z","1.1.12":"2026-01-16T07:30:31.832Z","1.1.14":"2026-01-16T07:43:22.018Z","1.1.15":"2026-01-19T21:04:25.685Z","1.1.16":"2026-01-19T21:11:26.466Z","1.1.17":"2026-01-20T06:02:04.878Z","1.1.18":"2026-01-29T20:41:11.538Z","2.0.0":"2026-03-17T19:22:17.860Z"},"bugs":{"url":"https://github.com/limehawk/superops-mcp/issues"},"author":{"name":"Limehawk"},"license":"MIT","homepage":"https://github.com/limehawk/superops-mcp/tree/main/packages/msp#readme","keywords":["mcp","superops","msp","graphql","api","claude","ai"],"repository":{"url":"git+https://github.com/limehawk/superops-mcp.git","type":"git","directory":"packages/msp"},"description":"MCP server for SuperOps MSP API — 2-tool pattern with live GraphQL introspection","maintainers":[{"name":"limehawk","email":"cw@limehawk.io"}],"readme":"# SuperOps MSP MCP Server\n\nAn MCP server that gives AI assistants full access to the SuperOps MSP GraphQL API through two dynamic tools powered by live schema introspection.\n\n## What is SuperOps MSP?\n\nSuperOps MSP is for **Managed Service Providers** - IT companies that manage technology for multiple client businesses. Key concepts:\n\n- **Multi-tenant**: One MSP serves many clients\n- **Client-based**: Data organized by Client → Site → Assets/Tickets\n- **Billing included**: Invoice and billing features for client management\n\n## Installation\n\n```bash\nbunx superops-msp@latest\n```\n\nOr with npx:\n\n```bash\nnpx superops-msp@latest\n```\n\n## Configuration\n\n### Claude Code\n\n```bash\nclaude mcp add superops-msp \\\n  -e SUPEROPS_API_KEY=your-api-key \\\n  -e SUPEROPS_SUBDOMAIN=your-subdomain \\\n  -- bunx superops-msp@latest\n```\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"superops-msp\": {\n      \"command\": \"bunx\",\n      \"args\": [\"superops-msp@latest\"],\n      \"env\": {\n        \"SUPEROPS_API_KEY\": \"your-api-key\",\n        \"SUPEROPS_SUBDOMAIN\": \"your-subdomain\"\n      }\n    }\n  }\n}\n```\n\n### Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `SUPEROPS_API_KEY` | Yes | Your SuperOps API key |\n| `SUPEROPS_SUBDOMAIN` | Yes | Your subdomain (e.g., `acme` from `acme.superops.ai`) |\n| `SUPEROPS_REGION` | No | `us` (default) or `eu` |\n| `SUPEROPS_TIMEOUT` | No | Request timeout in ms (default: 30000) |\n| `SUPEROPS_READ_ONLY` | No | Set to `true` to block mutations |\n\nGet your API key from **SuperOps Admin > API Settings**.\n\n## Tools\n\n### `superops-api`\n\nExecute any SuperOps API operation by name. The server builds the GraphQL query automatically from the introspected schema.\n\n```\nsuperops-api({ operation: \"getPriorityList\" })\n\nsuperops-api({\n  operation: \"getTicket\",\n  params: { ticketId: \"25507674456317952\" }\n})\n\nsuperops-api({\n  operation: \"getTicketList\",\n  params: { page: 1, pageSize: 10 }\n})\n\nsuperops-api({\n  operation: \"createTicket\",\n  params: {\n    subject: \"Printer not working\",\n    requestType: \"Incident\",\n    clientId: \"12345\"\n  }\n})\n```\n\n### `superops-api-schema`\n\nDiscover available operations and their parameter schemas. Four modes:\n\n**Category summary** (no params):\n```\nsuperops-api-schema()\n→ Lists all categories with operation counts\n```\n\n**Category detail**:\n```\nsuperops-api-schema({ category: \"Ticket\" })\n→ Lists all ticket operations with descriptions\n```\n\n**Operation detail**:\n```\nsuperops-api-schema({ operation: \"getTicket\" })\n→ Full parameter schema, argument types, return fields\n```\n\n**Usage examples**:\n```\nsuperops-api-schema({ examples: true })\n→ All usage patterns, gotchas, and ID field conventions\n\nsuperops-api-schema({ operation: \"getTicketList\", examples: true })\n→ Operation schema + specific usage example with filtering patterns\n```\n\n## API Coverage\n\nThe server exposes every operation available in the SuperOps MSP GraphQL API — currently **169 operations** (97 queries + 72 mutations) including:\n\n- Tickets, conversations, notes\n- Assets, software, patches, disks, alerts\n- Clients, sites, contacts, contracts\n- Invoices, quotes, taxes\n- Knowledge base articles and collections\n- Scripts and execution\n- Worklogs and time tracking\n- Webhooks and subscriptions\n- Approvals and SLAs\n- Service catalog items\n- IT documentation\n- Technicians, teams, groups, roles\n\nOperations are discovered via live GraphQL introspection. When SuperOps adds new API operations, they're available immediately.\n\n## Transport\n\nThe server supports three transport modes:\n\n| Mode | Flag | Use Case |\n|------|------|----------|\n| stdio | *(default)* | Claude Code, Claude Desktop |\n| Streamable HTTP | `--http` | Web clients, containers |\n| Legacy SSE | `--sse` | Older MCP clients |\n\nHTTP mode exposes `/mcp` (Streamable HTTP), `/sse` + `/messages` (legacy), and `/health`.\n\n## API Limits\n\n- Maximum 800 API requests per minute\n- Date/time values must be in UTC with ISO format (e.g., `2026-03-17T10:15:30`)\n- Use `null` to clear/reset attribute values\n\n## API Endpoints\n\n- **US**: `https://api.superops.ai/msp`\n- **EU**: `https://euapi.superops.ai/msp`\n\n## Related\n\n- [superops-it](https://npmjs.com/package/superops-it) - For SuperOps IT Teams (internal IT departments)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}