{"_id":"@helicone/mcp","_rev":"8-ace222be2affc134fde3c2fc2f64674c","name":"@helicone/mcp","dist-tags":{"latest":"0.1.6"},"versions":{"0.1.0":{"name":"@helicone/mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","claude","ai","helicone","observability","monitoring","llm"],"author":{"name":"Helicone, Inc."},"license":"Apache-2.0","_id":"@helicone/mcp@0.1.0","maintainers":[{"name":"justintorre75","email":"justintorre75@gmail.com"},{"name":"colegottdank","email":"colegottdank@gmail.com"},{"name":"kavinvalli.helicone","email":"kavin@helicone.ai"},{"name":"connortbot","email":"connor@helicone.ai"},{"name":"_juliettech","email":"juliette.chevaliera@gmail.com"}],"homepage":"https://github.com/Helicone/helicone#readme","bugs":{"url":"https://github.com/Helicone/helicone/issues"},"bin":{"mcp":"dist/index.js"},"dist":{"shasum":"e204359bebd30f07183d7d0c1f37d40938e243a1","tarball":"https://registry.npmjs.org/@helicone/mcp/-/mcp-0.1.0.tgz","fileCount":4,"integrity":"sha512-UMw/WEmRfGqrVesbORA8Gq0JvnLivJC6Hnui/aUrPOxujzwfklIJMaspFb67+Bm8aO3Puv37Jf+iDqrpmR+i2A==","signatures":[{"sig":"MEYCIQCIfNb3vpf8kPWwbQbPlBRmARfeF3VS9YVed0CFXs2obgIhAKVeahb49UL+4cMVGSKW+V9p4qNlwnrzN+b9wlgfGvW+","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6057},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"579db72c4eb0370bdead1263ef3066662e3fabd3","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","format":"biome format --write","lint:fix":"biome lint --fix","type-check":"tsc --noEmit"},"_npmUser":{"name":"connortbot","email":"connor@helicone.ai"},"repository":{"url":"git+ssh://git@github.com/Helicone/helicone.git","type":"git","directory":"helicone-mcp"},"_npmVersion":"11.6.2","description":"Model Context Protocol server for Helicone observability platform","directories":{},"_nodeVersion":"20.19.1","dependencies":{"zod":"^3.25.76","express":"^4.18.2","@modelcontextprotocol/sdk":"^1.20.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","typescript":"5.9.3","@types/node":"^24.9.2","@biomejs/biome":"^2.2.5","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1761784448638_0.29731182272345613","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@helicone/mcp","version":"0.1.1","keywords":["mcp","model-context-protocol","claude","ai","helicone","observability","monitoring","llm"],"author":{"name":"Helicone, Inc."},"license":"Apache-2.0","_id":"@helicone/mcp@0.1.1","maintainers":[{"name":"justintorre75","email":"justintorre75@gmail.com"},{"name":"colegottdank","email":"colegottdank@gmail.com"},{"name":"kavinvalli.helicone","email":"kavin@helicone.ai"},{"name":"connortbot","email":"connor@helicone.ai"},{"name":"_juliettech","email":"juliette.chevaliera@gmail.com"}],"homepage":"https://github.com/Helicone/helicone#readme","bugs":{"url":"https://github.com/Helicone/helicone/issues"},"bin":{"mcp":"dist/index.js"},"dist":{"shasum":"0636d11e1b702c91be5bc86158a7a0b89339b897","tarball":"https://registry.npmjs.org/@helicone/mcp/-/mcp-0.1.1.tgz","fileCount":7,"integrity":"sha512-tnFLi6olEZn4lKclNVtdEZE5fcLAVnaWhIMKlAQaT+paOglIL3v8kL43jOHYpU+LsK2M5zu2ReF7j0APBHHD6Q==","signatures":[{"sig":"MEQCIASXGxoWW5pDAMpoXG/MO2GQwiVcTT4/bzBLvYh2ITBCAiA0iWlo8UISSQfBkb2WMNhopw/XBiiYSV6Dy+KEZFN8Hw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18616},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"e39dd4ef7d8a78af9ba803b406c6106cafac34b6","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","format":"biome format --write","lint:fix":"biome lint --fix","type-check":"tsc --noEmit","generate-zod":"npm run flatten-types && ts-to-zod src/types/flat.ts src/types/generated-zod.ts && npm run build","flatten-types":"tsx flatten-types.ts"},"_npmUser":{"name":"connortbot","email":"connor@helicone.ai"},"repository":{"url":"git+ssh://git@github.com/Helicone/helicone.git","type":"git","directory":"helicone-mcp"},"_npmVersion":"11.6.2","description":"Model Context Protocol server for Helicone observability platform","directories":{},"_nodeVersion":"20.19.1","dependencies":{"zod":"^3.25.76","express":"^4.18.2","@modelcontextprotocol/sdk":"^1.20.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","typescript":"5.9.3","@types/node":"^24.9.2","@biomejs/biome":"^2.2.5","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1761787930672_0.5404285404912583","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@helicone/mcp","version":"0.1.2","keywords":["mcp","model-context-protocol","claude","ai","helicone","observability","monitoring","llm"],"author":{"name":"Helicone, Inc."},"license":"Apache-2.0","_id":"@helicone/mcp@0.1.2","maintainers":[{"name":"justintorre75","email":"justintorre75@gmail.com"},{"name":"colegottdank","email":"colegottdank@gmail.com"},{"name":"kavinvalli.helicone","email":"kavin@helicone.ai"},{"name":"connortbot","email":"connor@helicone.ai"},{"name":"_juliettech","email":"juliette.chevaliera@gmail.com"}],"homepage":"https://github.com/Helicone/helicone#readme","bugs":{"url":"https://github.com/Helicone/helicone/issues"},"bin":{"helicone-mcp":"dist/index.js"},"dist":{"shasum":"29609f0e27fe453b79cf0fd91a5b10b43a6ab346","tarball":"https://registry.npmjs.org/@helicone/mcp/-/mcp-0.1.2.tgz","fileCount":7,"integrity":"sha512-3I1wVTJgFYzKmjGX04znzmd118PH6991kS5ULcMy8/U5OY0VFAIaOXXU5o0itIg5KXDSNw5F330Vno/vi4WZJg==","signatures":[{"sig":"MEYCIQDTrxa1zGh+1dJ0zRwaOhwRUkuRG4VukXxH1KEy7x8vaAIhAMM+e75mY+AmprT6kgCpPwxzGGZM3XWRYYOuudMRM0iH","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18685},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"e39dd4ef7d8a78af9ba803b406c6106cafac34b6","scripts":{"dev":"tsx src/index.ts","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","format":"biome format --write","lint:fix":"biome lint --fix","type-check":"tsc --noEmit","generate-zod":"npm run flatten-types && ts-to-zod src/types/flat.ts src/types/generated-zod.ts && npm run build","flatten-types":"tsx flatten-types.ts"},"_npmUser":{"name":"connortbot","email":"connor@helicone.ai"},"repository":{"url":"git+ssh://git@github.com/Helicone/helicone.git","type":"git","directory":"helicone-mcp"},"_npmVersion":"11.6.2","description":"Model Context Protocol server for Helicone observability platform","directories":{},"_nodeVersion":"20.19.1","dependencies":{"zod":"^3.25.76","express":"^4.18.2","@modelcontextprotocol/sdk":"^1.20.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","typescript":"5.9.3","@types/node":"^24.9.2","@biomejs/biome":"^2.2.5","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.2_1761788728799_0.18632566118053795","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@helicone/mcp","version":"0.1.4","keywords":["mcp","model-context-protocol","claude","ai","helicone","observability","monitoring","llm"],"author":{"name":"Helicone, Inc."},"license":"Apache-2.0","_id":"@helicone/mcp@0.1.4","maintainers":[{"name":"justintorre75","email":"justintorre75@gmail.com"},{"name":"colegottdank","email":"colegottdank@gmail.com"},{"name":"kavinvalli.helicone","email":"kavin@helicone.ai"},{"name":"connortbot","email":"connor@helicone.ai"},{"name":"_juliettech","email":"juliette.chevaliera@gmail.com"}],"homepage":"https://github.com/Helicone/helicone#readme","bugs":{"url":"https://github.com/Helicone/helicone/issues"},"bin":{"helicone-mcp":"build/index.js"},"dist":{"shasum":"efa5b96deaf6a179b7361a04f58fb2e4afa46e43","tarball":"https://registry.npmjs.org/@helicone/mcp/-/mcp-0.1.4.tgz","fileCount":7,"integrity":"sha512-9U0afeay69D+5QOBhTPtCbJ4C+o3B/wbFLd9fbSLbKzLDtu2JIHokWQt+C/ce6dLekstfbcYGvlM3RQUZUNYTg==","signatures":[{"sig":"MEYCIQD50frz4iz3Cek7/orYqZY1bAlQ+EvyflmlSmXIc1mVZQIhAK7oXNPNQgVbXolRalvdLgEIaqxoucqPnrYeNSGzy1yQ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17061},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","gitHead":"e39dd4ef7d8a78af9ba803b406c6106cafac34b6","scripts":{"dev":"tsx src/index.ts","build":"tsc && chmod 755 build/index.js","start":"node build/index.js","format":"biome format --write","lint:fix":"biome lint --fix","type-check":"tsc --noEmit","generate-zod":"npm run flatten-types && ts-to-zod src/types/flat.ts src/types/generated-zod.ts && npm run build","flatten-types":"tsx flatten-types.ts"},"_npmUser":{"name":"connortbot","email":"connor@helicone.ai"},"repository":{"url":"git+ssh://git@github.com/Helicone/helicone.git","type":"git","directory":"helicone-mcp"},"_npmVersion":"11.6.2","description":"Model Context Protocol server for Helicone observability platform","directories":{},"_nodeVersion":"20.19.1","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.20.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","typescript":"5.9.3","@types/node":"^24.9.2","@biomejs/biome":"^2.2.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.4_1761790075269_0.5037636630872377","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@helicone/mcp","version":"0.1.5","keywords":["mcp","model-context-protocol","claude","ai","helicone","observability","monitoring","llm"],"author":{"name":"Helicone, Inc."},"license":"Apache-2.0","_id":"@helicone/mcp@0.1.5","maintainers":[{"name":"justintorre75","email":"justintorre75@gmail.com"},{"name":"colegottdank","email":"colegottdank@gmail.com"},{"name":"kavinvalli.helicone","email":"kavin@helicone.ai"},{"name":"connortbot","email":"connor@helicone.ai"},{"name":"_juliettech","email":"juliette.chevaliera@gmail.com"}],"homepage":"https://github.com/Helicone/helicone#readme","bugs":{"url":"https://github.com/Helicone/helicone/issues"},"bin":{"helicone-mcp":"build/index.js"},"dist":{"shasum":"cafd9d0680698492d7c23cd6e170a12ec320ca42","tarball":"https://registry.npmjs.org/@helicone/mcp/-/mcp-0.1.5.tgz","fileCount":7,"integrity":"sha512-V2Hi9X/tPZ4ablv2Oz2HNAek3V6kzKgalG+f3+YuQdW19x7anoK/WQtZG7fMg7/GlGSSeV+HUOSFodOkV7bWPQ==","signatures":[{"sig":"MEQCIAOMNGhg4cBpMsSRwDiXZKDW6jUlRemi7FUaVuuUZHtMAiAI6rvtWEuH/GFhAqaEsAKbyP0bQP1xT5k5Hv05MyNTPg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17083},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","gitHead":"721e494ce3f5efce73f021f9b9254406bc2e0775","scripts":{"dev":"tsx src/index.ts","build":"tsc && chmod 755 build/index.js","start":"node build/index.js","format":"biome format --write","lint:fix":"biome lint --fix","type-check":"tsc --noEmit","generate-zod":"npm run flatten-types && ts-to-zod src/types/flat.ts src/types/generated-zod.ts && npm run build","flatten-types":"tsx flatten-types.ts"},"_npmUser":{"name":"connortbot","email":"connor@helicone.ai"},"repository":{"url":"git+ssh://git@github.com/Helicone/helicone.git","type":"git","directory":"helicone-mcp"},"_npmVersion":"11.6.2","description":"Model Context Protocol server for Helicone observability platform","directories":{},"_nodeVersion":"20.19.1","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.20.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","typescript":"5.9.3","@types/node":"^24.9.2","@biomejs/biome":"^2.2.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.5_1762296573472_0.698856370842923","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@helicone/mcp","version":"0.1.6","keywords":["mcp","model-context-protocol","claude","ai","helicone","observability","monitoring","llm"],"author":{"name":"Helicone, Inc."},"license":"Apache-2.0","_id":"@helicone/mcp@0.1.6","maintainers":[{"name":"justintorre75","email":"justintorre75@gmail.com"},{"name":"colegottdank","email":"colegottdank@gmail.com"},{"name":"kavinvalli.helicone","email":"kavin@helicone.ai"},{"name":"connortbot","email":"connor@helicone.ai"},{"name":"_juliettech","email":"juliette.chevaliera@gmail.com"}],"homepage":"https://github.com/Helicone/helicone#readme","bugs":{"url":"https://github.com/Helicone/helicone/issues"},"bin":{"helicone-mcp":"build/index.js"},"dist":{"shasum":"f6e652c6d2a2e8261c04d880529f412948f21268","tarball":"https://registry.npmjs.org/@helicone/mcp/-/mcp-0.1.6.tgz","fileCount":7,"integrity":"sha512-vW9J4AW5O8Yl7wElUJq3nW1tvVB+IYWgMQ0R47fMMGvK+XU5fj9uR7zyjRkubkWCVvgu9s8Q3kIPXBq1NLnqvQ==","signatures":[{"sig":"MEQCIHzxSpYUmoqj6IL7Qth9hG0GKZU9KOLQeUxl0RyRASxFAiBBj+NYvoKGVyYM1XsdrMvSsbxMXzjPEdOHeMxIRyKRQA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18553},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","gitHead":"e10b2b8afb7bb146c982b7a3b7ce0295c20ddadd","scripts":{"dev":"tsx src/index.ts","build":"tsc && chmod 755 build/index.js","start":"node build/index.js","format":"biome format --write","lint:fix":"biome lint --fix","type-check":"tsc --noEmit","generate-zod":"npm run flatten-types && ts-to-zod src/types/flat.ts src/types/generated-zod.ts && npm run build","flatten-types":"tsx flatten-types.ts"},"_npmUser":{"name":"connortbot","email":"connor@helicone.ai"},"repository":{"url":"git+ssh://git@github.com/Helicone/helicone.git","type":"git","directory":"helicone-mcp"},"_npmVersion":"11.6.2","description":"Model Context Protocol server for Helicone observability platform","directories":{},"_nodeVersion":"20.19.1","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.20.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","typescript":"5.9.3","@types/node":"^24.9.2","@biomejs/biome":"^2.2.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.6_1762296871057_0.7949092017783534","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-10-30T00:34:08.565Z","modified":"2026-10-13T22:21:52.770Z","0.1.0":"2025-10-30T00:34:08.822Z","0.1.1":"2025-10-30T01:32:10.898Z","0.1.2":"2025-10-30T01:45:29.040Z","0.1.4":"2025-10-30T02:07:55.494Z","0.1.5":"2025-11-04T22:49:33.657Z","0.1.6":"2025-11-04T22:54:31.247Z"},"bugs":{"url":"https://github.com/Helicone/helicone/issues"},"author":{"name":"Helicone, Inc."},"license":"Apache-2.0","homepage":"https://github.com/Helicone/helicone#readme","keywords":["mcp","model-context-protocol","claude","ai","helicone","observability","monitoring","llm"],"repository":{"url":"git+ssh://git@github.com/Helicone/helicone.git","type":"git","directory":"helicone-mcp"},"description":"Model Context Protocol server for Helicone observability platform","maintainers":[{"email":"justintorre75@gmail.com","name":"justintorre75"},{"email":"colegottdank@gmail.com","name":"colegottdank"}],"readme":"# Helicone MCP Server\n\nA Model Context Protocol (MCP) server for querying Helicone observability platform data.\n\n## Installation\n\n```json\n{\n  \"mcpServers\": {\n    \"helicone\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"@helicone/mcp@latest\"],\n      \"env\": {\n        \"HELICONE_API_KEY\": \"sk-helicone-xxxxxxx-xxxxxxx-xxxxxxx-xxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n### `query_requests`\n\nQuery requests with filters, pagination, sorting, and optional body content.\n\n**Parameters:**\n- `filter` (optional): Filter criteria (model, provider, status, latency, cost, properties, time, user, etc.)\n- `offset`, `limit` (optional): Pagination (default: 0, 100)\n- `sort` (optional): Sort criteria\n- `includeBodies` (optional): Include request/response bodies (default: false)\n\n**Use cases:** Debugging errors, searching logs, analyzing performance, examining request/response bodies.\n\n### `query_sessions`\n\nQuery sessions with search, time range filtering, and advanced filters.\n\n**Parameters:**\n- `startTimeUnixMs`, `endTimeUnixMs` (required): Time range (Unix timestamp in milliseconds)\n- `timezoneDifference` (required): Timezone offset in hours (e.g., -5 for EST)\n- `search` (optional): Search by name or metadata\n- `nameEquals` (optional): Exact name match\n- `filter` (optional): Advanced filter criteria\n- `offset`, `limit` (optional): Pagination (default: 0, 100)\n\n**Use cases:** Search sessions, debug conversations, analyze session flows, filter requests by session.\n\nBoth tools support full filter capabilities including model/provider, status/error, time, cost/latency, custom properties, and complex AND/OR combinations.\n\n## API Key\n\nGet your API key from [Settings → API Keys](https://us.helicone.ai/settings/api-keys) (or for [EU](https://eu.helicone.ai/settings/api-keys)) and set it as `HELICONE_API_KEY` in your MCP configuration.","readmeFilename":"README.md"}