Servidor MCP

northflank

io.usefulapi/northflank

Qué hace este MCP

Inspects and controls Northflank projects, services, jobs, builds, addons, domains, scaling, and service lifecycle operations.

northflank_get_addon
Get addon
Get details and status of a single addon. GET /v1/projects/{projectId}/addons/{addonId}.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'addonId'], 'properties': {'addonId': {'type': 'string', 'description': 'Addon id (from northflank_list_addons).'}, 'projectId': {'type': 'string', 'description': 'Project id.'}}}
northflank_get_job
Get job
Get details of a single job, including build/deploy config and cron schedule. GET /v1/projects/{projectId}/jobs/{jobId}.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'jobId'], 'properties': {'jobId': {'type': 'string', 'description': 'Job id (from northflank_list_jobs).'}, 'projectId': {'type': 'string', 'description': 'Project id.'}}}
northflank_get_project
Get project
Get details of a single project, including region, cluster and associated services/jobs/addons. GET /v1/projects/{projectId}.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId'], 'properties': {'projectId': {'type': 'string', 'description': 'Project id (from northflank_list_projects).'}}}
northflank_get_service
Get service
Get details and current status of a single service. GET /v1/projects/{projectId}/services/{serviceId}.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'serviceId'], 'properties': {'projectId': {'type': 'string', 'description': 'Project id.'}, 'serviceId': {'type': 'string', 'description': 'Service id (from northflank_list_services).'}}}
northflank_get_service_metrics
Get service metrics
Get CPU / memory metrics for a service's containers. GET /v1/projects/{projectId}/services/{serviceId}/metrics. Use queryType=single (default) for a current snapshot or queryType=range with duration/startTime/endTime.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'serviceId'], 'properties': {'time': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Point-in-time for queryType=single.'}, 'endTime': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Range end.'}, 'duration': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Range duration in seconds (alternative to startTime/endTime).', 'exclusiveMinimum': 0}, 'projectId': {'type': 'string', 'description': 'Project id.'}, 'queryType': {'enum': ['single', 'range'], 'type': 'string', 'description': 'single = point-in-time (default), range = time series.'}, 'serviceId': {'type': 'string', 'description': 'Service id.'}, 'startTime': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Range start (unix ms/seconds per API).'}, 'metricTypes': {'type': 'array', 'items': {'enum': ['cpu', 'memory'], 'type': 'string'}, 'description': 'Which metrics to return; defaults to all if omitted.'}}}
northflank_list_addons
List addons
List addons (managed databases / services) in a project with their status. GET /v1/projects/{projectId}/addons.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Page number to access.', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'description': "Cursor from a previous page's pagination.cursor to fetch the next page."}, 'per_page': {'type': 'integer', 'maximum': 100, 'description': 'Results per page (max 100).', 'exclusiveMinimum': 0}, 'projectId': {'type': 'string', 'description': 'Project id.'}}}
northflank_list_domains
List domains
List custom domains for the account (or a team), with verification status. GET /v1/domains (team: GET /v1/teams/{teamId}/domains).
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Page number to access.', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'description': "Cursor from a previous page's pagination.cursor to fetch the next page."}, 'teamId': {'type': 'string', 'description': "Optional team id to scope to a team's domains."}, 'per_page': {'type': 'integer', 'maximum': 100, 'description': 'Results per page (max 100).', 'exclusiveMinimum': 0}}}
northflank_list_jobs
List jobs
List jobs (manual / cron) in a project. GET /v1/projects/{projectId}/jobs.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Page number to access.', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'description': "Cursor from a previous page's pagination.cursor to fetch the next page."}, 'per_page': {'type': 'integer', 'maximum': 100, 'description': 'Results per page (max 100).', 'exclusiveMinimum': 0}, 'projectId': {'type': 'string', 'description': 'Project id.'}}}
northflank_list_projects
List projects
List projects for the authenticated token (or a specific team). Good first call to discover project ids. GET /v1/projects (team: GET /v1/teams/{teamId}/projects).
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Page number to access.', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'description': "Cursor from a previous page's pagination.cursor to fetch the next page."}, 'teamId': {'type': 'string', 'description': "Optional team id to scope to a team's projects."}, 'per_page': {'type': 'integer', 'maximum': 100, 'description': 'Results per page (max 100).', 'exclusiveMinimum': 0}}}
northflank_list_secret_groups
List secret groups
List a project's secret groups — METADATA ONLY (id, name, type, priority, restrictions). Does NOT return secret values. GET /v1/projects/{projectId}/secrets.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Page number to access.', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'description': "Cursor from a previous page's pagination.cursor to fetch the next page."}, 'per_page': {'type': 'integer', 'maximum': 100, 'description': 'Results per page (max 100).', 'exclusiveMinimum': 0}, 'projectId': {'type': 'string', 'description': 'Project id.'}}}
northflank_list_service_builds
List service builds
List a build service's build runs / history (branch, sha, status, timestamps). GET /v1/projects/{projectId}/services/{serviceId}/build.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'serviceId'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Page number to access.', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'description': "Cursor from a previous page's pagination.cursor to fetch the next page."}, 'per_page': {'type': 'integer', 'maximum': 100, 'description': 'Results per page (max 100).', 'exclusiveMinimum': 0}, 'projectId': {'type': 'string', 'description': 'Project id.'}, 'serviceId': {'type': 'string', 'description': 'Service id of a build/combined service.'}}}
northflank_list_services
List services
List services in a project (build / deployment / combined) with their build+deployment status. GET /v1/projects/{projectId}/services.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Page number to access.', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'description': "Cursor from a previous page's pagination.cursor to fetch the next page."}, 'per_page': {'type': 'integer', 'maximum': 100, 'description': 'Results per page (max 100).', 'exclusiveMinimum': 0}, 'projectId': {'type': 'string', 'description': 'Project id.'}}}
northflank_pause_service
Pause service (mutates infra)
MUTATING: pause a service, scaling it to zero running instances. POST /v1/projects/{projectId}/services/{serviceId}/pause.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'serviceId'], 'properties': {'projectId': {'type': 'string', 'description': 'Project id.'}, 'serviceId': {'type': 'string', 'description': 'Service id.'}}}
northflank_restart_service
Restart service (mutates infra)
MUTATING: restart all running containers of a service. POST /v1/projects/{projectId}/services/{serviceId}/restart.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'serviceId'], 'properties': {'projectId': {'type': 'string', 'description': 'Project id.'}, 'serviceId': {'type': 'string', 'description': 'Service id.'}}}
northflank_resume_service
Resume service (mutates infra)
MUTATING: resume a paused service. Optionally set the instance count and CI/CD/autoscaling state to restore. POST /v1/projects/{projectId}/services/{serviceId}/resume.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'serviceId'], 'properties': {'instances': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Instances to scale to on resume.'}, 'projectId': {'type': 'string', 'description': 'Project id.'}, 'serviceId': {'type': 'string', 'description': 'Service id.'}, 'disabledCD': {'type': 'boolean', 'description': 'Whether CD should be disabled after resume.'}, 'disabledCI': {'type': 'boolean', 'description': 'Whether CI should be disabled after resume.'}, 'enableAutoscaling': {'type': 'boolean', 'description': 'Restore autoscaling (defaults to the state captured when paused).'}}}
northflank_scale_service
Scale service (mutates infra)
MUTATING: set the number of running instances (replicas) for a service. POST /v1/projects/{projectId}/services/{serviceId}/scale.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'serviceId', 'instances'], 'properties': {'instances': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Desired number of instances / replicas.'}, 'projectId': {'type': 'string', 'description': 'Project id.'}, 'serviceId': {'type': 'string', 'description': 'Service id.'}}}
northflank_trigger_service_build
Trigger service build (mutates infra)
MUTATING: start a new build for a build/combined service. With an empty body it builds the latest commit on the linked branch; optionally target a branch, a specific commit sha, or a pull request. POST /v1/projects/{projectId}/services/{serviceId}/build.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'serviceId'], 'properties': {'sha': {'type': 'string', 'description': 'Specific commit SHA to build from the branch.'}, 'branch': {'type': 'string', 'description': "Branch to build (defaults to the service's linked branch)."}, 'projectId': {'type': 'string', 'description': 'Project id.'}, 'serviceId': {'type': 'string', 'description': 'Build/combined service id.'}, 'pullRequestId': {'type': 'string', 'description': "Build the latest commit of this pull request's branch."}}}
Añadido
northflank_resume_service
21 de September de 2026 a las 02:44
Añadido
northflank_pause_service
21 de September de 2026 a las 02:44
Añadido
northflank_scale_service
21 de September de 2026 a las 02:44
Añadido
northflank_restart_service
21 de September de 2026 a las 02:44
Añadido
northflank_trigger_service_build
21 de September de 2026 a las 02:44
Añadido
northflank_list_domains
21 de September de 2026 a las 02:44
Añadido
northflank_list_secret_groups
21 de September de 2026 a las 02:44
Añadido
northflank_get_service_metrics
21 de September de 2026 a las 02:44
Añadido
northflank_list_service_builds
21 de September de 2026 a las 02:44
Añadido
northflank_get_addon
21 de September de 2026 a las 02:44
Añadido
northflank_list_addons
21 de September de 2026 a las 02:44
Añadido
northflank_get_job
21 de September de 2026 a las 02:44
Añadido
northflank_list_jobs
21 de September de 2026 a las 02:44
Añadido
northflank_get_service
21 de September de 2026 a las 02:44
Añadido
northflank_list_services
21 de September de 2026 a las 02:44
Añadido
northflank_get_project
21 de September de 2026 a las 02:44
Añadido
northflank_list_projects
21 de September de 2026 a las 02:44