{"_id":"@bucketeer/mcp","_rev":"2-48d2a8e9fa18f7f776e1e90aa805db76","name":"@bucketeer/mcp","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.2":{"name":"@bucketeer/mcp","version":"1.0.2","keywords":["mcp","bucketeer","feature-flags","model-context-protocol"],"author":"","license":"Apache-2.0","_id":"@bucketeer/mcp@1.0.2","maintainers":[{"name":"kentakozuka","email":"kenta.kozuka@gmail.com"},{"name":"bucketeer-bot","email":"bucketeer@cyberagent.co.jp"}],"homepage":"https://github.com/bucketeer-io/bucketeer-mcp#readme","bugs":{"url":"https://github.com/bucketeer-io/bucketeer-mcp/issues"},"bin":{"mcp":"dist/index.js"},"dist":{"shasum":"66f6616db665216f3bfbc3c0102f1e91470d0916","tarball":"https://registry.npmjs.org/@bucketeer/mcp/-/mcp-1.0.2.tgz","fileCount":51,"integrity":"sha512-sWOAt7TOckYTw2O6xUgxVLViPpzJRHJN0QBpnGUq4YUZgMVelLu5mCem42V0IJm6lCJybmLrGB19UtNtarYATA==","signatures":[{"sig":"MEYCIQCATR2296futpVcPFIM4B/G32G2oC7bRBc7Ub72d126IAIhAKqnOMmTpEt6Cl33M+/Z4zLLsXoai02Fhg161+dsB7z4","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bucketeer%2fmcp@1.0.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":110392},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"b3c14f51886aeb04fac205305b12a70e1865bdce","scripts":{"dev":"tsx src/index.ts","lint":"biome lint","build":"tsc","check":"biome check","clean":"rm -rf dist","start":"node dist/index.js","format":"biome format","lint:fix":"biome lint --write","check:fix":"biome check --write","format:fix":"biome format --write","type-check":"tsc --noEmit"},"_npmUser":{"name":"bucketeer-bot","email":"bucketeer@cyberagent.co.jp"},"repository":{"url":"git+https://github.com/bucketeer-io/bucketeer-mcp.git","type":"git"},"_npmVersion":"11.4.2","description":"MCP server for Bucketeer feature flags management","directories":{},"_nodeVersion":"24.4.1","dependencies":{"zod":"^4.0.0","axios":"^1.7.2","dotenv":"^17.0.0","@modelcontextprotocol/sdk":"^1.15.1"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org","@bucketeer:registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.15.7","typescript":"^5.5.2","@types/node":"^22.0.0","@biomejs/biome":"2.1.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.2_1753773560225_0.6909791533662959","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-07-29T07:19:20.143Z","modified":"2026-05-15T06:47:37.808Z","1.0.2":"2025-07-29T07:19:20.438Z"},"bugs":{"url":"https://github.com/bucketeer-io/bucketeer-mcp/issues"},"license":"Apache-2.0","homepage":"https://github.com/bucketeer-io/bucketeer-mcp#readme","keywords":["mcp","bucketeer","feature-flags","model-context-protocol"],"repository":{"url":"git+https://github.com/bucketeer-io/bucketeer-mcp.git","type":"git"},"description":"MCP server for Bucketeer feature flags management","maintainers":[{"email":"bucketeer@cyberagent.co.jp","name":"bucketeer-bot"}],"readme":"# Bucketeer MCP Server\n\nA Model Context Protocol (MCP) server for managing feature flags in [Bucketeer](https://bucketeer.io/), an open-source feature flag management platform.\n\n\n> [!WARNING]\n> This is a beta version. Breaking changes may be introduced before general release.\n\n## Features\n\nThis MCP server provides tools for basic CRUD operations on Bucketeer feature flags:\n\n- `listFeatureFlags` - List all feature flags with filtering and pagination\n- `createFeatureFlag` - Create a new feature flag\n- `getFeatureFlag` - Get a specific feature flag by ID\n- `updateFeatureFlag` - Update an existing feature flag\n- `archiveFeatureFlag` - Archive a feature flag (make it inactive)\n\n## Prerequisites\n\n- Node.js 18 or higher\n- A Bucketeer instance with API access\n- An API key with appropriate permissions (READ, WRITE, or ADMIN)\n\n## Installation\n\n1. Clone this repository\n```bash\ngit clone https://github.com/yourusername/bucketeer-mcp.git\ncd bucketeer-mcp\n```\n\n2. Install dependencies\n```bash\nnpm install\n```\n\n3. Build the project\n```bash\nnpm run build\n```\n\n## Usage\n\n### Running the Server\n\nStart the MCP server\n```bash\nnpm start\n```\n\nFor development with auto-reload\n```bash\nnpm run dev\n```\n\n### MCP Client Configuration\n\nTo use this server with an MCP client, add it to your MCP client configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"bucketeer\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/bucketeer-mcp/dist/index.js\"],\n      \"env\": {\n        \"BUCKETEER_HOST\": \"api.bucketeer.io\",\n        \"BUCKETEER_API_KEY\": \"your-api-key\",\n        \"BUCKETEER_ENVIRONMENT_ID\": \"your-environment-id\"\n      }\n    }\n  }\n}\n```\n\n### Available Tools\n\n#### listFeatureFlags\n\nList all feature flags in the specified environment.\n\nParameters:\n- `environmentId` (optional) - Environment ID (uses default if not provided)\n- `pageSize` (optional) - Number of items per page (1-100, default: 20)\n- `cursor` (optional) - Pagination cursor for next page\n- `tags` (optional) - Filter by tags\n- `orderBy` (optional) - Field to order by (CREATED_AT, UPDATED_AT, NAME)\n- `orderDirection` (optional) - Order direction (ASC, DESC)\n- `searchKeyword` (optional) - Search keyword for feature name or ID\n- `maintainer` (optional) - Filter by maintainer email\n- `archived` (optional) - Filter by archived status\n\n#### createFeatureFlag\n\nCreate a new feature flag.\n\nParameters:\n- `id` (required) - Unique identifier (alphanumeric, hyphens, underscores)\n- `name` (required) - Human-readable name\n- `description` (optional) - Description of the feature flag\n- `environmentId` (optional) - Environment ID (uses default if not provided)\n- `variations` (required) - Array of variations (at least 2)\n  - `value` (required) - The value returned when this variation is served\n  - `name` (required) - Name of the variation\n  - `description` (optional) - Description of the variation\n- `tags` (optional) - Tags for the feature flag\n- `defaultOnVariationIndex` (required) - Index of variation when flag is on (0-based)\n- `defaultOffVariationIndex` (required) - Index of variation when flag is off (0-based)\n- `variationType` (optional) - Type of the variation values: STRING (default), BOOLEAN, NUMBER, or JSON\n\n#### getFeatureFlag\n\nGet a specific feature flag by ID.\n\nParameters:\n- `id` (required) - The ID of the feature flag to retrieve\n- `environmentId` (optional) - Environment ID (uses default if not provided)\n- `featureVersion` (optional) - Specific version of the feature to retrieve\n\n#### updateFeatureFlag\n\nUpdate an existing feature flag.\n\nParameters:\n- `id` (required) - The ID of the feature flag to update\n- `comment` (required) - Comment for the update (required for audit trail)\n- `environmentId` (optional) - Environment ID (uses default if not provided)\n- `name` (optional) - New name for the feature flag\n- `description` (optional) - New description\n- `tags` (optional) - New tags\n- `enabled` (optional) - Enable or disable the feature flag\n- `archived` (optional) - Archive or unarchive the feature flag\n\nNote: \n- This tool requires a comment for audit trail purposes\n- It does not support updating variations. To modify variations, you would need to archive the current flag and create a new one.\n\n#### archiveFeatureFlag\n\nArchive a feature flag (make it inactive). Archived flags will return the default value defined in your code for all users.\n\nParameters:\n- `id` (required) - The ID of the feature flag to archive\n- `environmentId` (optional) - Environment ID (uses default if not provided)\n- `comment` (required) - Comment for the archive action (required for audit trail)\n\nNote: This operation archives the flag rather than permanently deleting it. The flag can be unarchived later if needed.\n\n\n## Development\n\n\n### Linting\n\nRun the linter\n```bash\nnpm run lint\n```\n\n### Building\n\nBuild the TypeScript code\n```bash\nnpm run build\n```\n\n## Contributing\n\nWe would ❤️ for you to contribute to Bucketeer and help improve it! Anyone can use and enjoy it!\n\nPlease follow our contribution guide [here](https://docs.bucketeer.io/contribution-guide/).\n\n## License\n\nApache License 2.0, see [LICENSE](https://github.com/bucketeer-io/openfeature-go-server-sdk/blob/main/LICENSE).","readmeFilename":"README.md"}