{"_id":"@enterpret/jira-product-discovery-mcp","_rev":"3-981ba75e8c8cce272b10ebec8cf7c0fb","name":"@enterpret/jira-product-discovery-mcp","dist-tags":{"latest":"0.2.0"},"versions":{"0.2.0":{"name":"@enterpret/jira-product-discovery-mcp","version":"0.2.0","keywords":["mcp","typescript","claude","anthropic","ai","atlassian","jira","project-management","issue-tracking","server","model-context-protocol","tools","resources","tooling","ai-integration","mcp-server","llm","ai-connector","external-tools","cli","mcp-inspector"],"author":{"name":"Andi Ashari"},"license":"ISC","_id":"@enterpret/jira-product-discovery-mcp@0.2.0","maintainers":[{"name":"shwetankshrey","email":"shwetank@enterpret.com"},{"name":"ishitamundhra","email":"ishita@enterpret.com"}],"homepage":"https://github.com/aavaz-ai/jira-product-discovery-mcp#readme","bugs":{"url":"https://github.com/aavaz-ai/jira-product-discovery-mcp/issues"},"bin":{"jira-product-discovery-mcp":"dist/index.js"},"dist":{"shasum":"68d1e737c3ff4290eceef2c71ee4d9c71a269cab","tarball":"https://registry.npmjs.org/@enterpret/jira-product-discovery-mcp/-/jira-product-discovery-mcp-0.2.0.tgz","fileCount":54,"integrity":"sha512-ksxrXsUOctOXpY2uw95LVCnRCFbAcQe32xrL75J+tUCTyNe430f00iIFGchi/7EfD5nNRB9qRLwgqmttT9tncg==","signatures":[{"sig":"MEYCIQDfekGi78j2Isoufr0/4Eujw8HKLPGjljYPltDo2JZSNwIhAO9JvA2KlSZEX7WKYYBNH/FQHhEagujd3eLfju1DqVqi","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":195274},"jest":{"preset":"ts-jest","testMatch":["**/src/**/*.test.ts"],"transform":{"^.+\\.tsx?$":["ts-jest",{"useESM":true}]},"testEnvironment":"node","moduleNameMapper":{"(.*)\\.(js|jsx)$":"$1"},"coverageReporters":["text","lcov","json-summary"],"setupFilesAfterEnv":["<rootDir>/src/utils/jest.setup.ts"],"collectCoverageFrom":["src/**/*.ts","!src/**/*.test.ts","!src/**/*.spec.ts"],"moduleFileExtensions":["ts","tsx","js","jsx","json","node"],"extensionsToTreatAsEsm":[".ts"],"coveragePathIgnorePatterns":["/node_modules/","/dist/","/coverage/"]},"main":"dist/index.js","type":"commonjs","_from":"file:/private/tmp/jpd-bootstrap-release.P4C7Pn/enterpret-jira-product-discovery-mcp-0.2.0.tgz","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"scripts":{"cli":"npm run build && node dist/index.js","lint":"eslint src --ext .ts --config eslint.config.mjs","test":"jest","build":"npm run clean && tsc","clean":"rm -rf dist coverage","format":"prettier --write 'src/**/*.ts' 'scripts/**/*.js'","dev:cli":"DEBUG=true npm run build && DEBUG=true node dist/index.js","prepare":"npm run build && node scripts/ensure-executable.js","dev:http":"DEBUG=true TRANSPORT_MODE=http npm run build && node dist/index.js","mcp:http":"TRANSPORT_MODE=http npm run build && node dist/index.js","test:cli":"jest src/cli/.*\\.cli\\.test\\.ts --runInBand --testTimeout=60000","dev:stdio":"npm run build && npx @modelcontextprotocol/inspector -e TRANSPORT_MODE=stdio -e DEBUG=true node dist/index.js","mcp:stdio":"TRANSPORT_MODE=stdio npm run build && node dist/index.js","start:cli":"npm run build && node dist/index.js","dev:server":"DEBUG=true npm run build && npx @modelcontextprotocol/inspector -e DEBUG=true node dist/index.js","mcp:inspect":"TRANSPORT_MODE=http npm run build && (node dist/index.js &) && sleep 2 && npx @modelcontextprotocol/inspector http://localhost:3000/mcp","publish:npm":"npm publish","update:deps":"npx npm-check-updates -u && npm install --legacy-peer-deps","format:check":"prettier --check 'src/**/*.ts' 'scripts/**/*.js'","start:server":"npm run build && npx @modelcontextprotocol/inspector node dist/index.js","update:check":"npx npm-check-updates","test:coverage":"jest --coverage","update:version":"node scripts/update-version.js"},"_npmUser":{"name":"shwetankshrey","email":"shwetank@enterpret.com"},"_resolved":"/private/tmp/jpd-bootstrap-release.P4C7Pn/enterpret-jira-product-discovery-mcp-0.2.0.tgz","_integrity":"sha512-ksxrXsUOctOXpY2uw95LVCnRCFbAcQe32xrL75J+tUCTyNe430f00iIFGchi/7EfD5nNRB9qRLwgqmttT9tncg==","repository":{"url":"git+https://github.com/aavaz-ai/jira-product-discovery-mcp.git","type":"git"},"_npmVersion":"11.17.0","description":"MCP server for Jira Cloud REST APIs, native Jira Product Discovery Insights, and supporting attachments.","directories":{},"_nodeVersion":"26.4.0","dependencies":{"zod":"^4.1.13","cors":"^2.8.5","dotenv":"^17.2.3","express":"^5.2.1","jmespath":"^0.16.0","turndown":"^7.2.2","commander":"^14.0.2","@toon-format/toon":"^2.0.1","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^30.2.0","eslint":"^9.39.1","nodemon":"^3.1.11","ts-jest":"^29.4.5","ts-node":"^10.9.2","prettier":"^3.7.3","@eslint/js":"^9.39.1","node-fetch":"^3.3.2","typescript":"^5.9.3","@types/cors":"^2.8.19","@types/jest":"^30.0.0","@types/node":"^24.10.1","@types/express":"^5.0.5","@types/jmespath":"^0.15.2","@types/turndown":"^5.0.6","npm-check-updates":"^19.1.2","typescript-eslint":"^8.48.0","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.4","eslint-plugin-filenames":"^1.3.2","@typescript-eslint/parser":"^8.48.0","@typescript-eslint/eslint-plugin":"^8.48.0"},"_npmOperationalInternal":{"tmp":"tmp/jira-product-discovery-mcp_0.2.0_1784318379107_0.2875061855832628","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-07-17T19:59:39.000Z","modified":"2026-09-29T15:23:57.129Z","0.2.0":"2026-07-17T19:59:39.335Z"},"bugs":{"url":"https://github.com/aavaz-ai/jira-product-discovery-mcp/issues"},"author":{"name":"Andi Ashari"},"license":"ISC","homepage":"https://github.com/aavaz-ai/jira-product-discovery-mcp#readme","keywords":["mcp","typescript","claude","anthropic","ai","atlassian","jira","project-management","issue-tracking","server","model-context-protocol","tools","resources","tooling","ai-integration","mcp-server","llm","ai-connector","external-tools","cli","mcp-inspector"],"repository":{"url":"git+https://github.com/aavaz-ai/jira-product-discovery-mcp.git","type":"git"},"description":"MCP server for Jira Cloud REST APIs, native Jira Product Discovery Insights, and supporting attachments.","maintainers":[{"email":"shwetank@enterpret.com","name":"shwetankshrey"},{"email":"ishita@enterpret.com","name":"ishitamundhra"},{"email":"tanay@enterpret.com","name":"eternaltangent"},{"email":"amandeep@enterpret.com","name":"amand33p_s"}],"readme":"# Jira Product Discovery MCP\n\nAn MCP server for Jira Cloud and Jira Product Discovery. It exposes the existing\ngeneric Jira REST tools together with typed native JPD Insight and attachment\noperations.\n\nPackage: `@enterpret/jira-product-discovery-mcp`\n\n## Tool surface\n\nThe server exposes exactly eight tools:\n\n| Tool                      | Purpose                                                              |\n| ------------------------- | -------------------------------------------------------------------- |\n| `jira_get`                | Read from a Jira REST endpoint.                                      |\n| `jira_post`               | Create through a Jira REST endpoint.                                 |\n| `jira_put`                | Replace through a Jira REST endpoint.                                |\n| `jira_patch`              | Partially update through a Jira REST endpoint.                       |\n| `jira_delete`             | Delete through a Jira REST endpoint.                                 |\n| `jira_add_attachment`     | Upload one UTF-8 or base64 attachment to an issue or JPD idea.       |\n| `jira_list_jpd_insights`  | List native JPD Insights for an idea key.                            |\n| `jira_create_jpd_insight` | Create a native JPD Insight with linked evidence in its description. |\n\nThe generic tools preserve compatibility with Jira REST API v3. Callers provide\nonly the REST path, query parameters, and request body; authentication remains\nserver-owned.\n\n## Authentication\n\n### OAuth bearer mode\n\nEnterpret Agent uses Nango to refresh the Jira 3LO connection and injects the\nshort-lived access token into the MCP subprocess:\n\n```bash\nATLASSIAN_OAUTH_BEARER=<access-token> \\\n  npx -y @enterpret/jira-product-discovery-mcp@0.2.0\n```\n\nNative JPD Insight tools require this mode. They do not accept tokens, Atlassian\nIDs, GraphQL, or OAuth client IDs as tool arguments.\n\nSet `ATLASSIAN_CLOUD_ID` when the bearer can access more than one Atlassian\nsite. The server verifies the configured cloud ID against Atlassian's accessible\nresources and otherwise fails closed on ambiguous multi-site connections.\n\n### Jira API token mode\n\nThe generic Jira REST tools and attachment tool also support Jira API-token\nauthentication:\n\n```bash\nATLASSIAN_SITE_NAME=your-instance\nATLASSIAN_USER_EMAIL=you@example.com\nATLASSIAN_API_TOKEN=<api-token>\n```\n\nThis mode does not support native JPD Insights.\n\n## MCP configuration\n\nThe default transport is stdio:\n\n```json\n{\n\t\"mcpServers\": {\n\t\t\"jira-product-discovery\": {\n\t\t\t\"command\": \"npx\",\n\t\t\t\"args\": [\"-y\", \"@enterpret/jira-product-discovery-mcp@0.2.0\"],\n\t\t\t\"env\": {\n\t\t\t\t\"ATLASSIAN_OAUTH_BEARER\": \"<access-token>\"\n\t\t\t}\n\t\t}\n\t}\n}\n```\n\nSupply secrets through the subprocess environment, never through MCP tool\narguments or command-line flags.\n\n## Native JPD Insights\n\n`jira_list_jpd_insights` accepts a human-friendly idea key such as `MDP-2`.\nThe server resolves the selected Atlassian cloud, project ID, and issue ID, then\nconstructs the fixed Polaris ARIs internally.\n\n`jira_create_jpd_insight` accepts:\n\n- `ideaKey`\n- `description`\n- `quote`\n- `sourceUrl` (HTTPS)\n- `sourceTitle`\n\nIt creates a native JPD Insight with an Atlassian Document Format description\ncontaining the summary, quote, and linked source. It does not create a structured\nsource snippet and does not require `ATLASSIAN_OAUTH_CLIENT_ID`.\n\nCreation is intentionally marked non-idempotent. Retrying a create after an\nambiguous provider response can create a duplicate Insight.\n\nNative Insights currently use Atlassian's experimental Polaris GraphQL surface.\nThe server exposes only fixed, typed list and create operations; arbitrary\nGraphQL and raw Polaris input are not available.\n\nSee [JPD snippet representations](docs/JPD-SNIPPETS.md) for the difference\nbetween description-only Insights and structured source snippets.\n\n## Attachments\n\n`jira_add_attachment` accepts an issue or idea key, filename, content, optional\nencoding (`utf8` or `base64`), and optional MIME type. The server builds Jira's\nmultipart request and limits decoded files to 10 MiB. Repeated calls create\nseparate Jira attachments.\n\n## Data handling\n\nGeneric Jira REST calls retain the inherited raw-response diagnostics under\n`/tmp/mcp/jira-product-discovery-mcp/`. These files can contain Jira request and\nresponse payloads and should be handled accordingly. Attachment uploads are\nmarked sensitive, so attachment bytes and returned content URLs are excluded\nfrom debug and raw-response output.\n\nLarge generic Jira responses are truncated for the MCP caller and include the\ncorresponding raw-response path. Jira pagination, field selection, and the\ngeneric tools' `jq` filter can be used to request a smaller result.\n\n## Development\n\nRequires Node.js 18 or newer.\n\n```bash\nnpm ci\nnpm run format:check\nnpm run lint\nnpm run build\nnpm test -- --runInBand\nnpm pack --dry-run\n```\n\nTests use mocked provider responses for JPD and attachment operations. Do not\nuse production Atlassian credentials for local test runs.\n\n## Releasing\n\nPublishing is manual and never runs on a push to `main`. The release workflow\nvalidates the candidate, packs once, smoke-tests that exact tarball through\n`npx`, and publishes the same artifact with npm Trusted Publishing provenance.\n\nSee the [release runbook](https://github.com/aavaz-ai/jira-product-discovery-mcp/blob/main/RELEASING.md)\nfor the one-time npm bootstrap, Trusted Publishing configuration, release gates,\nand post-publication verification.\n\n## License and ancestry\n\nISC licensed. This repository retains the generic Jira foundation and history\nfrom Andi Ashari's Jira MCP project and adds Enterpret's Jira Product Discovery\nintegration. See [LICENSE](LICENSE).\n","readmeFilename":"README.md"}