Create, target and roll out feature flags. Production changes wait for a person to approve.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Railflag access token as Bearer rf_pat_… (Settings → Access tokens)
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Writes the plan into one Railflag environment. Running it again changes nothing. Environments that need approval return an approvalUrl for a person. Never writes to the source vendor.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http railflag https://mcp.railflag.com/mcp \ --header 'Authorization: Bearer YOUR_TOKEN'
Headers
Authorization (required): Railflag access token as Bearer rf_pat_… (Settings → Access tokens)Writes the plan into one Railflag environment. Running it again changes nothing. Environments that need approval return an approvalUrl for a person. Never writes to the source vendor.
| Argument | Type | Description |
|---|---|---|
| planId* | string | |
| environment* | string | |
| planVersion | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"planId",
"environment"
],
"properties": {
"planId": {
"type": "string"
},
"environment": {
"type": "string"
},
"planVersion": {
"type": "integer"
}
},
"additionalProperties": false
}Asks the source vendor what sample users get (AB Tasty: Decision API, needs a Decision API key on the connection; Unleash: its server-side playground) without recording anything, and compares with the plan. Runs in the background: poll get_run.
| Argument | Type | Description |
|---|---|---|
| planId* | string | |
| contexts | array | Specific users to check; each needs a "key" (the user id) |
| sampleSize | integer | |
| environment* | string | Railflag environment key in the plan |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"planId",
"environment"
],
"properties": {
"planId": {
"type": "string"
},
"contexts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
},
"description": "Specific users to check; each needs a \"key\" (the user id)"
},
"sampleSize": {
"type": "integer",
"maximum": 2000,
"minimum": 1
},
"environment": {
"type": "string",
"description": "Railflag environment key in the plan"
}
},
"additionalProperties": false
}Starts connecting Prometheus/Grafana, Datadog, Sentry, New Relic or a Slack channel for alerts. Returns a one-time link: give it to the user, who enters the credentials there. Never ask the user for credentials in chat. Admins only.
| Argument | Type | Description |
|---|---|---|
| name | string | |
| vendor* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"vendor"
],
"properties": {
"name": {
"type": "string"
},
"vendor": {
"enum": [
"prometheus",
"datadog",
"sentry",
"newrelic",
"slack"
],
"type": "string"
}
},
"additionalProperties": false
}Starts a read-only connection to the user's account at another flag vendor (see list_sources). Returns a link the user opens to enter their credentials there. Never ask the user to paste credentials into the chat. After they finish, call get_connection.
| Argument | Type | Description |
|---|---|---|
| vendor* | string | Which vendor to import from |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"vendor"
],
"properties": {
"vendor": {
"enum": [
"abtasty",
"unleash"
],
"type": "string",
"description": "Which vendor to import from"
}
},
"additionalProperties": false
}Creates a flag, off in every environment. Boolean flags have variations [false, true].
| Argument | Type | Description |
|---|---|---|
| key* | string | Key used in code, e.g. new-checkout |
| kind | string | |
| name* | string | |
| tags | array | |
| type | string | |
| variations | array | Required for string/number/json flags |
| description | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"key",
"name"
],
"properties": {
"key": {
"type": "string",
"description": "Key used in code, e.g. new-checkout"
},
"kind": {
"enum": [
"release",
"ops",
"experiment",
"permission"
],
"type": "string"
},
"name": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"type": {
"enum": [
"boolean",
"string",
"number",
"json"
],
"type": "string",
"default": "boolean"
},
"variations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"value": {}
},
"additionalProperties": false
},
"description": "Required for string/number/json flags"
},
"description": {
"type": "string"
}
},
"additionalProperties": false
}Deletes the stored credentials for a source connection.
| Argument | Type | Description |
|---|---|---|
| connectionId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"connectionId"
],
"properties": {
"connectionId": {
"type": "string"
}
},
"additionalProperties": false
}The source vendor's definition of one flag next to what it becomes in Railflag, and its issues.
| Argument | Type | Description |
|---|---|---|
| key* | string | |
| planId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"planId",
"key"
],
"properties": {
"key": {
"type": "string"
},
"planId": {
"type": "string"
}
},
"additionalProperties": false
}Status of a change waiting for approval: pending, applied, rejected or failed.
| Argument | Type | Description |
|---|---|---|
| id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
},
"additionalProperties": false
}How to rewrite the source vendor's SDK calls to OpenFeature with Railflag: setup, regex patterns, before/after examples, notes. Apply it in the user's repo yourself and show them the diff.
| Argument | Type | Description |
|---|---|---|
| vendor* | string | |
| language | string | Language of the code to migrate |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"vendor"
],
"properties": {
"vendor": {
"enum": [
"abtasty",
"unleash"
],
"type": "string"
},
"language": {
"enum": [
"typescript",
"javascript",
"python",
"go",
"java",
"kotlin"
],
"type": "string",
"description": "Language of the code to migrate"
}
},
"additionalProperties": false
}Whether the user finished connecting, which source environments are visible, and whether decisions can be compared.
| Argument | Type | Description |
|---|---|---|
| connectionId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"connectionId"
],
"properties": {
"connectionId": {
"type": "string"
}
},
"additionalProperties": false
}One flag: variations and full targeting in every environment, with versions for safe updates.
| Argument | Type | Description |
|---|---|---|
| key* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"key"
],
"properties": {
"key": {
"type": "string"
}
},
"additionalProperties": false
}Audit log for the project or one flag: who changed what, when and why.
| Argument | Type | Description |
|---|---|---|
| key | string | |
| limit | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"key": {
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 200
}
},
"additionalProperties": false
}A plan's summary, issues and items. full=true includes each item's targeting.
| Argument | Type | Description |
|---|---|---|
| full | boolean | |
| planId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"planId"
],
"properties": {
"full": {
"type": "boolean"
},
"planId": {
"type": "string"
}
},
"additionalProperties": false
}Status and result of a scan, compare or apply run.
| Argument | Type | Description |
|---|---|---|
| runId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"runId"
],
"properties": {
"runId": {
"type": "string"
}
},
"additionalProperties": false
}A watch: its status (draft, active, passed, paused, stopped), each signal's state, the timeline and the verdict.
| Argument | Type | Description |
|---|---|---|
| id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
},
"additionalProperties": false
}Environments, whether they require approval, and their published config versions. Keys are not returned.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}All flags with their state in each environment.
| Argument | Type | Description |
|---|---|---|
| search | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"search": {
"type": "string"
}
},
"additionalProperties": false
}Vendors Railflag can import flags from, what it reads from each, and which are coming later.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}Watches in the project, newest first, optionally for one flag and by status (comma separated: draft, active, passed, paused, stopped, expired).
| Argument | Type | Description |
|---|---|---|
| key | string | |
| status | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"key": {
"type": "string"
},
"status": {
"type": "string"
}
},
"additionalProperties": false
}The project's monitoring coverage: live Production flags nobody watches (ranked by risk), kill switches never tested, flags no SDK evaluates, and services missing error or latency metrics. Business plan.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}Builds a dry-run plan from the latest scan. envMap maps source environment ids (from get_connection or the scan) to Railflag environment keys, e.g. {"production": "staging"} to try production data in staging first. Nothing is written.
| Argument | Type | Description |
|---|---|---|
| envMap* | object | |
| connectionId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"connectionId",
"envMap"
],
"properties": {
"envMap": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"connectionId": {
"type": "string"
}
},
"additionalProperties": false
}Undoes one apply run: restores previous targeting and archives flags it created.
| Argument | Type | Description |
|---|---|---|
| runId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"runId"
],
"properties": {
"runId": {
"type": "string"
}
},
"additionalProperties": false
}Reads all flags and their targeting from the connected vendor (read only). Runs in the background: poll get_run with the returned runId.
| Argument | Type | Description |
|---|---|---|
| connectionId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"connectionId"
],
"properties": {
"connectionId": {
"type": "string"
}
},
"additionalProperties": false
}Sets the percentage split for the default rule, or for one rule by id. percentages has one number per variation and must add up to 100 (e.g. [80, 20] gives 20% true for a boolean flag). Raising a percentage only adds users.
| Argument | Type | Description |
|---|---|---|
| key* | string | |
| reason | string | |
| ruleId | string | |
| environment* | string | |
| percentages* | array | |
| watchPlanId | string | A Release Watch plan from suggest_watch_plan: it starts watching when this change is applied |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"key",
"environment",
"percentages"
],
"properties": {
"key": {
"type": "string"
},
"reason": {
"type": "string"
},
"ruleId": {
"type": "string"
},
"environment": {
"type": "string"
},
"percentages": {
"type": "array",
"items": {
"type": "number",
"maximum": 100,
"minimum": 0
}
},
"watchPlanId": {
"type": "string",
"format": "uuid",
"description": "A Release Watch plan from suggest_watch_plan: it starts watching when this change is applied"
}
},
"additionalProperties": false
}Stops watching. Doesn't change the flag.
| Argument | Type | Description |
|---|---|---|
| id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
},
"additionalProperties": false
}Drafts a Release Watch plan for a flag change: which signals to monitor (error rate, latency, conversions, new Sentry issues, the rollout split), the limits, and for how long. Describe the change with percentages (default rule split, like set_rollout), enabled (on/off) or a full targeting. Returns a watchPlanId to pass to the change tool. On plans without Release Watch it says what it would monitor instead.
| Argument | Type | Description |
|---|---|---|
| key* | string | |
| enabled | boolean | |
| autoPause | boolean | Pause the rollout on its own when a limit stays broken. Off unless the user asks for it. |
| targeting | object | |
| environment* | string | |
| percentages | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"key",
"environment"
],
"properties": {
"key": {
"type": "string"
},
"enabled": {
"type": "boolean"
},
"autoPause": {
"type": "boolean",
"description": "Pause the rollout on its own when a limit stays broken. Off unless the user asks for it."
},
"targeting": {
"type": "object",
"required": [
"enabled",
"offVariation",
"fallthrough"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"clauses",
"serve"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"serve": {
"anyOf": [
{
"$ref": "#/properties/targeting/properties/fallthrough/anyOf/0"
},
{
"$ref": "#/properties/targeting/properties/fallthrough/anyOf/1"
}
]
},
"clauses": {
"type": "array",
"items": {
"type": "object",
"required": [
"attr",
"op",
"values"
],
"properties": {
"op": {
"enum": [
"in",
"exists",
"startsWith",
"endsWith",
"contains",
"matches",
"lt",
"lte",
"gt",
"gte",
"semverEq",
"semverLt",
"semverGt",
"before",
"after",
"segmentMatch"
],
"type": "string"
},
"attr": {
"type": "string",
"description": "Context attribute, or \"key\" for the user key"
},
"negate": {
"type": "boolean"
},
"values": {
"type": "array",
"items": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"enabled": {
"type": "boolean"
},
"targets": {
"type": "array",
"items": {
"type": "object",
"required": [
"variation",
"values"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "string"
}
},
"variation": {
"type": "integer"
}
},
"additionalProperties": false
}
},
"fallthrough": {
"anyOf": [
{
"type": "object",
"required": [
"variation"
],
"properties": {
"variation": {
"type": "integer",
"description": "Variation index"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"rollout"
],
"properties": {
"rollout": {
"type": "object",
"required": [
"weights"
],
"properties": {
"weights": {
"type": "array",
"items": {
"type": "integer"
},
"description": "One weight per variation, out of 100000 (100000 = 100%)"
},
"bucketBy": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"description": "Default rule: what users who match nothing get"
},
"offVariation": {
"type": "integer"
},
"prerequisites": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"variation"
],
"properties": {
"key": {
"type": "string"
},
"variation": {
"type": "integer"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"environment": {
"type": "string"
},
"percentages": {
"type": "array",
"items": {
"type": "number",
"maximum": 100,
"minimum": 0
}
}
},
"additionalProperties": false
}Turns a flag on or off in one environment. In environments that need approval this returns an approvalUrl for a person.
| Argument | Type | Description |
|---|---|---|
| key* | string | |
| reason | string | |
| enabled* | boolean | |
| environment* | string | |
| watchPlanId | string | A Release Watch plan from suggest_watch_plan: it starts watching when this change is applied |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"key",
"environment",
"enabled"
],
"properties": {
"key": {
"type": "string"
},
"reason": {
"type": "string"
},
"enabled": {
"type": "boolean"
},
"environment": {
"type": "string"
},
"watchPlanId": {
"type": "string",
"format": "uuid",
"description": "A Release Watch plan from suggest_watch_plan: it starts watching when this change is applied"
}
},
"additionalProperties": false
}Records decisions on issues. Each issue lists its allowed actions: skip_flag, drop_rule, keep, rename (value = new key), overwrite. Info issues need no decision. Ask the user when the choice is not obviously safe.
| Argument | Type | Description |
|---|---|---|
| planId* | string | |
| decisions* | array | |
| baseVersion | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"planId",
"decisions"
],
"properties": {
"planId": {
"type": "string"
},
"decisions": {
"type": "array",
"items": {
"type": "object",
"required": [
"issueId",
"action"
],
"properties": {
"value": {
"type": "string"
},
"action": {
"enum": [
"skip_flag",
"drop_rule",
"keep",
"rename",
"overwrite"
],
"type": "string"
},
"issueId": {
"type": "string"
}
},
"additionalProperties": false
}
},
"baseVersion": {
"type": "integer"
}
},
"additionalProperties": false
}Replaces a flag's targeting in one environment. Read it with get_flag first and pass its version as baseVersion so you never overwrite someone else's change. Rules are checked top to bottom; the first match wins.
| Argument | Type | Description |
|---|---|---|
| key* | string | |
| reason | string | |
| targeting* | object | |
| baseVersion* | integer | |
| environment* | string | |
| watchPlanId | string | A Release Watch plan from suggest_watch_plan: it starts watching when this change is applied |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"key",
"environment",
"targeting",
"baseVersion"
],
"properties": {
"key": {
"type": "string"
},
"reason": {
"type": "string"
},
"targeting": {
"type": "object",
"required": [
"enabled",
"offVariation",
"fallthrough"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"clauses",
"serve"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"serve": {
"anyOf": [
{
"$ref": "#/properties/targeting/properties/fallthrough/anyOf/0"
},
{
"$ref": "#/properties/targeting/properties/fallthrough/anyOf/1"
}
]
},
"clauses": {
"type": "array",
"items": {
"type": "object",
"required": [
"attr",
"op",
"values"
],
"properties": {
"op": {
"enum": [
"in",
"exists",
"startsWith",
"endsWith",
"contains",
"matches",
"lt",
"lte",
"gt",
"gte",
"semverEq",
"semverLt",
"semverGt",
"before",
"after",
"segmentMatch"
],
"type": "string"
},
"attr": {
"type": "string",
"description": "Context attribute, or \"key\" for the user key"
},
"negate": {
"type": "boolean"
},
"values": {
"type": "array",
"items": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"enabled": {
"type": "boolean"
},
"targets": {
"type": "array",
"items": {
"type": "object",
"required": [
"variation",
"values"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "string"
}
},
"variation": {
"type": "integer"
}
},
"additionalProperties": false
}
},
"fallthrough": {
"anyOf": [
{
"type": "object",
"required": [
"variation"
],
"properties": {
"variation": {
"type": "integer",
"description": "Variation index"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"rollout"
],
"properties": {
"rollout": {
"type": "object",
"required": [
"weights"
],
"properties": {
"weights": {
"type": "array",
"items": {
"type": "integer"
},
"description": "One weight per variation, out of 100000 (100000 = 100%)"
},
"bucketBy": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"description": "Default rule: what users who match nothing get"
},
"offVariation": {
"type": "integer"
},
"prerequisites": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"variation"
],
"properties": {
"key": {
"type": "string"
},
"variation": {
"type": "integer"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"baseVersion": {
"type": "integer"
},
"environment": {
"type": "string"
},
"watchPlanId": {
"type": "string",
"format": "uuid",
"description": "A Release Watch plan from suggest_watch_plan: it starts watching when this change is applied"
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 19, 2026.