How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Flagsmith MCP API

MCP-compatible endpoints.

Flagsmith MCP API is one of 24 APIs that Flagsmith publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include MCP. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 54 operations across 40 paths, and defines 111 schemas. It is described by OpenAPI 3.2.0, at version v1.

Requests are made against the base URL https://edge.api.flagsmith.com.

54 operations 40 paths 111 schemas 2 DELETE31 GET12 POST9 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v1
Base URL
https://edge.api.flagsmith.com
Authentication
HTTP Bearer, HTTP Basic, API Key, API Key, HTTP Basic, API Key
License
BSD License
Resource Areas
1

Authentication & Security 6

Flagsmith MCP API declares 6 security schemes for authenticating requests. It accepts HTTP bearer tokens (Cohort_Sync_Key). It accepts HTTP basic authentication (Cohort_Sync_Key__Basic). An API key is passed in the header as X-Environment-Key (Environment_API_Key). An API key is passed in the header as Authorization (Master_API_Key). It accepts HTTP basic authentication (basicAuth). An API key is passed in the header as Authorization (tokenAuth).

  • Cohort_Sync_Key — For cohort sync endpoints called by an external cohort source, such as Amplitude.
  • Cohort_Sync_Key__Basic — For cohort sync endpoints called by an external cohort source that can only send Basic credentials, such as Mixpanel. The key is the password; the username is…
  • Environment_API_Key — For SDK endpoints. Find out more .
  • Master_API_Key — For Management API endpoints. Find out more .
  • tokenAuth — Token-based authentication with required prefix "Token"

Paths & Operations 54

Across 40 paths, the API surfaces 54 operations — 2 DELETE, 31 GET, 12 POST, 9 PUT. Each is listed below with its method, path, parameters, and response codes.

MCP 54

MCP-compatible endpoints.

GET
/api/v1/environments/
List environments
list_environments 2 params → 200
POST
/api/v1/environments/{environment_api_key}/create-change-request/
Create environment feature change request
create_environment_feature_change_request 1 param body → 201400
GET
/api/v1/environments/{environment_api_key}/experiment-metrics/
List metrics
list_metrics 4 params → 200
POST
/api/v1/environments/{environment_api_key}/experiment-metrics/
Create metric
create_metric 1 param body → 201
GET
/api/v1/environments/{environment_api_key}/experiment-metrics/{id}/
Get metric
get_metric 2 params → 200
PUT
/api/v1/environments/{environment_api_key}/experiment-metrics/{id}/
Update metric
update_metric 2 params body → 200
GET
/api/v1/environments/{environment_api_key}/experiments/
List experiments
list_experiments 5 params → 200
POST
/api/v1/environments/{environment_api_key}/experiments/
Create experiment
create_experiment 1 param body → 201
GET
/api/v1/environments/{environment_api_key}/experiments/{experiment_id}/
Get experiment
get_experiment 2 params → 200
PUT
/api/v1/environments/{environment_api_key}/experiments/{experiment_id}/
Update experiment
update_experiment 2 params body → 200
GET
/api/v1/environments/{environment_api_key}/experiments/{experiment_id}/exposures/
Get experiment exposures
get_experiment_exposures 2 params → 200
GET
/api/v1/environments/{environment_api_key}/experiments/{experiment_id}/results/
Get experiment results
get_experiment_results 2 params → 200
POST
/api/v1/environments/{environment_api_key}/features/{feature_pk}/create-segment-override/
Create segment override
create_segment_override 2 params body → 201
PUT
/api/v1/environments/{environment_api_key}/featurestates/{id}/
Update environment feature state
update_environment_feature_state 2 params body → 200
GET
/api/v1/environments/{environment_api_key}/list-change-requests/
List environment change requests
list_environment_change_requests 8 params → 200400
GET
/api/v1/environments/{environment_pk}/feature-lifecycle-counts/
Get feature lifecycle counts
get_feature_lifecycle_counts 1 param → 200
GET
/api/v1/environments/{environment_pk}/features/{feature_pk}/versions/
Get environment feature versions
get_environment_feature_versions 4 params → 200
POST
/api/v1/environments/{environment_pk}/features/{feature_pk}/versions/
Create environment feature version
create_environment_feature_version 2 params body → 201
GET
/api/v1/environments/{environment_pk}/features/{feature_pk}/versions/{environment_feature_version_pk}/featurestates/
Get environment feature version states
get_environment_feature_version_states 3 params → 200
POST
/api/v1/environments/{environment_pk}/features/{feature_pk}/versions/{environment_feature_version_pk}/featurestates/
Create environment feature version state
create_environment_feature_version_state 3 params body → 201
PUT
/api/v1/environments/{environment_pk}/features/{feature_pk}/versions/{environment_feature_version_pk}/featurestates/{id}/
Update environment feature version state
update_environment_feature_version_state 4 params body → 200
POST
/api/v1/environments/{environment_pk}/features/{feature_pk}/versions/{id}/publish/
Publish environment feature version
publish_environment_feature_version 3 params body → 200
GET
/api/v1/features/feature-segments/
List feature segments
list_feature_segments 3 params → 200
DELETE
/api/v1/features/feature-segments/{id}/
Delete feature segment
delete_feature_segment 1 param → 204
PUT
/api/v1/features/featurestates/{id}/
Update feature state
update_feature_state 1 param body → 200
GET
/api/v1/organisations/
List organizations
list_organizations 1 param → 200
GET
/api/v1/organisations/{organisation_pk}/groups/
List organization groups
list_organization_groups 2 params → 200
GET
/api/v1/organisations/{organisation_pk}/invites/
List organization invites
list_organization_invites 2 params → 200
POST
/api/v1/organisations/{organisation_pk}/invites/
Create organization invite
create_organization_invite 1 param body → 201
GET
/api/v1/organisations/{organisation_pk}/roles/
List organization roles
list_organization_roles 2 params → 200
GET
/api/v1/organisations/{id}/projects/
List projects in organization
list_projects_in_organization 1 param → 200
GET
/api/v1/projects/{id}/
Get project
get_project 1 param → 200
PUT
/api/v1/projects/{id}/
Update project
update_project 1 param body → 200
GET
/api/v1/projects/{id}/environments/
List project environments
list_project_environments 1 param → 200
GET
/api/v1/projects/{project_pk}/change-requests/
List project change requests
list_project_change_requests 6 params → 200400
GET
/api/v1/projects/{project_pk}/feature-health/events/
Get feature health events
get_feature_health_events 1 param → 200
GET
/api/v1/projects/{project_pk}/features/
List project features
list_project_features 18 params → 200
POST
/api/v1/projects/{project_pk}/features/
Create feature
create_feature 1 param body → 201
GET
/api/v1/projects/{project_pk}/features/{feature_pk}/code-references/
Get feature code references
get_feature_code_references 2 params → 200
GET
/api/v1/projects/{project_pk}/features/{feature_pk}/feature-external-resources/
Get feature external resources
get_feature_external_resources 3 params → 200
GET
/api/v1/projects/{project_pk}/features/{feature_pk}/mv-options/
List feature multivariate options
list_feature_multivariate_options 3 params → 200
POST
/api/v1/projects/{project_pk}/features/{feature_pk}/mv-options/
Create feature multivariate option
create_feature_multivariate_option 2 params body → 201
PUT
/api/v1/projects/{project_pk}/features/{feature_pk}/mv-options/{id}/
Update feature multivariate option
update_feature_multivariate_option 3 params body → 200
DELETE
/api/v1/projects/{project_pk}/features/{feature_pk}/mv-options/{id}/
Delete feature multivariate option
delete_feature_multivariate_option 3 params → 204
GET
/api/v1/projects/{project_pk}/features/{id}/
Get feature flag
get_feature_flag 2 params → 200
PUT
/api/v1/projects/{project_pk}/features/{id}/
Update feature
update_feature 2 params body → 200
GET
/api/v1/projects/{project_pk}/features/{id}/evaluation-data/
Get feature evaluation data
get_feature_evaluation_data 7 params → 200
GET
/api/v1/projects/{project_pk}/release-pipelines/
List project release pipelines
list_project_release_pipelines 4 params → 200
GET
/api/v1/projects/{project_pk}/release-pipelines/{id}/
Get release pipeline
get_release_pipeline 2 params → 200
POST
/api/v1/projects/{project_pk}/release-pipelines/{id}/add-feature/
Add feature to release pipeline
add_feature_to_release_pipeline 2 params body → 200
GET
/api/v1/projects/{project_pk}/segments/
List project segments
list_project_segments 6 params → 200
POST
/api/v1/projects/{project_pk}/segments/
Create project segment
create_project_segment 1 param body → 201
GET
/api/v1/projects/{project_pk}/segments/{id}/
Get project segment
get_project_segment 2 params → 200
PUT
/api/v1/projects/{project_pk}/segments/{id}/
Update project segment
update_project_segment 2 params body → 200

Schemas 111

The contract defines 111 schemas that model the data the API accepts and returns. The most detailed are ListFeature (25 properties), UpdateFeature (25 properties), ProjectRetrieve (22 properties), EnvironmentSerializerWithMetadata (18 properties). Each schema is shown below with its type and property counts.

FeatureHealthEventReasonTextBlock
object
2 properties 1 required
WorkflowsError
object
1 property 1 required
Invite
object
5 properties 1 required
OrganisationSerializerFull
object
13 properties 1 required
AggregationEnum
string
count - Count sum - Sum mean - Mean occurrence - Occurrence (event happened at least once)
Experiment
object
11 properties 3 required
PaginatedMultivariateFeatureOptionList
object
4 properties 2 required
ListFeature
object
Functionality for serializers that need to handle metadata
25 properties 1 required
FeatureFlagCodeReferencesRepositoryCount
object
4 properties 4 required
ProjectRetrieve
object
22 properties 2 required
ReleasePipeline
object
8 properties 1 required
Role
object
5 properties 1 required
PaginatedExperimentListList
object
4 properties 2 required
PaginatedFeatureSegmentListList
object
4 properties 2 required
ProjectChangeRequestList
object
10 properties
InviteList
object
5 properties 2 required
MultivariateFeatureStateValue
object
3 properties 2 required
ChangeRequestCreate
object
Adds nested create feature
16 properties 2 required
Metadata
object
3 properties 2 required
FeatureExternalResourceTypeEnum
string
GITHUBISSUE - GitHub Issue GITHUBPR - GitHub PR GITLABISSUE - GitLab Issue GITLABMR - GitLab MR
FeatureExternalResource
object
5 properties 3 required
DirectionEnum
string
up - Higher is better down - Lower is better informational - Informational only
CreateChangeRequestFeatureState
object
Adds nested create feature
7 properties 1 required
MultivariateValue
object
2 properties 2 required
NullEnum
null
PaginatedFeatureExternalResourceList
object
4 properties 2 required
CustomCreateSegmentOverrideFeatureState
object
Adds nested create feature
14 properties 1 required
RoleEnum
string
ADMIN - Admin USER - User
FeatureStateSerializerBasic
object
Adds nested create feature
17 properties 1 required
CustomEnvironmentFeatureVersionFeatureState
object
Adds nested create feature
14 properties 1 required
ChangeRequestApproval
object
Adds nested create feature
3 properties 1 required
ManagedByEnum
string
- Unmanaged cohort - Cohort
ProjectUpdate
object
Mixin to add read only status to fields in a given serializer based on the existence of a subscription and a black list of plan ids Example usage: class MySeri…
17 properties 1 required
PaginatedMetricList
object
4 properties 2 required
FeatureHealthEventReasonUrlBlock
object
2 properties 1 required
ExperimentList
object
11 properties 2 required
ConditionOperatorEnum
string
EQUAL - Exactly Matches GREATERTHAN - Greater than LESSTHAN - Less than CONTAINS - Contains GREATERTHANINCLUSIVE - Greater than or equal to LESSTHANINCLUSIVE -…
ExperimentDetail
object
11 properties 2 required
EnvironmentFeatureVersionPublish
object
1 property
FeatureEvaluationData
object
3 properties 3 required
_SegmentCohort
object
7 properties 1 required
TriggerTypeEnum
string
ONENTER - Trigger when flag enters stage WAITFOR - Trigger after waiting for x amount of time
PaginatedInviteListList
object
4 properties 2 required
FeatureLifecycleCounts
object
Number of features in each lifecycle stage for an environment
6 properties 6 required
FeatureHealthEvent
object
7 properties 1 required
PaginatedSegmentList
object
4 properties 2 required
PaginatedListUserPermissionGroupList
object
4 properties 2 required
WritableNestedFeatureState
object
Adds nested create feature
17 properties 2 required
FeatureStateValue
object
4 properties
ActionTypeEnum
string
TOGGLEFEATURE - Enable/Disable Feature for the environment UPDATEFEATUREVALUE - Update Feature Value for the environment TOGGLEFEATUREFORSEGMENT - Enable/Disab…
FeatureFlagCodeReferencesRepositorySummary
object
6 properties 6 required
SegmentRuleTypeEnum
string
ALL - all ANY - any NONE - none
Type975Enum
string
int - Integer unicode - String bool - Boolean
PaginatedEnvironmentFeatureVersionList
object
4 properties 2 required
SegmentRule
object
Adds nested create feature
5 properties 1 required
ListUserPermissionGroup
object
5 properties 1 required
PipelineStage
object
Adds nested create feature
8 properties 5 required
EdgeV2MigrationStatusEnum
string
NOTSTARTED - Not Started INPROGRESS - In Progress COMPLETE - Complete INCOMPLETE - Incomplete (identity overrides skipped)
FeatureValue
object
2 properties 2 required
ListUserPermissionGroupMembership
object
6 properties 5 required
VersionChangeSet
object
Adds nested create feature
6 properties 4 required
FeatureValueTypeEnum
string
integer - integer string - string boolean - boolean
Labels
object
3 properties
PaginatedRoleList
object
4 properties 2 required
BillingStatusEnum
string
ACTIVE - Active DUNNING - Dunning
FeatureStateSerializerSmall
object
6 properties
UpdateFeature
object
prevent users from changing certain values after creation
25 properties
ExperimentFeature
object
5 properties
EnvironmentFeatureVersion
object
9 properties
PaginatedListFeatureList
object
4 properties 2 required
ChangeRequestGroupAssignment
object
Adds nested create feature
1 property 1 required
PaginatedProjectChangeRequestListList
object
4 properties 2 required
ExperimentAudience
object
2 properties 1 required
StageAction
object
3 properties
FeatureSegmentList
object
7 properties
_CodeReferenceDetail
object
7 properties 7 required
BlankEnum
PaymentMethodEnum
string
CHARGEBEE - Chargebee XERO - Xero AWSMARKETPLACE - AWS Marketplace
ReleasePipelineDetail
object
Adds nested create feature
10 properties 2 required
FeatureHealthEventReason
object
2 properties 2 required
Status7a8Enum
string
created - Created running - Running paused - Paused completed - Completed
MatchEnum
string
any - Any all - All
StageTrigger
object
3 properties
MultivariateFeatureOption
object
9 properties 1 required
SegmentMembershipCount
object
3 properties
PaginatedEnvironmentSerializerWithMetadataList
object
4 properties 2 required
SourceTypeEnum
string
csv - CSV amplitude - Amplitude mixpanel - Mixpanel
CustomCreateSegmentOverrideFeatureSegment
object
4 properties 1 required
ChangeRequestList
object
12 properties
ExperimentMetricInline
object
2 properties 2 required
Condition
object
6 properties 1 required
Subscription
object
14 properties
_NestedSegmentRule
object
Adds nested create feature
4 properties 1 required
EnvironmentFeatureVersionCreate
object
13 properties
TypeD77Enum
string
STANDARD - STANDARD MULTIVARIATE - MULTIVARIATE
LifecycleStageEnum
string
new - new live - live stale - stale permanent - permanent needsmonitoring - needsmonitoring toremove - toremove
PaginatedReleasePipelineList
object
4 properties 2 required
EnvironmentSerializerWithMetadata
object
Functionality for serializers that need to handle metadata
18 properties 2 required
NestedMultivariateFeatureOption
object
8 properties
PaginatedOrganisationSerializerFullList
object
4 properties 2 required
FeatureHealthEventTypeEnum
string
UNHEALTHY - Unhealthy HEALTHY - Healthy
VcsProviderEnum
string
github - GitHub
Metric
object
9 properties 2 required
ProjectList
object
17 properties 2 required
_MultivariateFeatureStateValue
object
3 properties 2 required
_FeatureStateValue
object
4 properties
ExpectedDirectionEnum
string
increase - Increase decrease - Decrease notincrease - Should not increase notdecrease - Should not decrease
ExperimentRollout
object
5 properties 3 required
UserList
object
6 properties 3 required
ExperimentMetric
object
7 properties 2 required
Segment
object
Functionality for serializers that need to handle metadata
15 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

flagsmith-mcp-api-openapi.yml Raw ↑

Other APIs Flagsmith publishes across the network.

Flagsmith Flags API
flagsmith Environments API
flagsmith Features API
flagsmith Identities API
flagsmith Organisations API
flagsmith Projects API
flagsmith Segments API
flagsmith Users API
flagsmith Webhooks API
Flagsmith Admin dashboard API
Flagsmith Analytics API
Flagsmith Audit API
Where this information came from

This is an independent, third-party profile of Flagsmith MCP API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.