Northflank MCP by usefulapi
by usefulapi.io · remote · no sign-in to list tools · v1.16.3 · published by io.usefulapi
Inspect and control your Northflank projects, services, jobs, and builds from your AI assistant.
17 tools: 5 can delete or cancel things and 12 only read.
Scanned Oct 21, 2026
- Deletes or cancels5Claude Code: deny: see these tools
- Can't be undone0Claude Code: ask
- Changes things0Claude Code: ask
- Only reads12Claude Code: allow: see these tools
No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http northflank https://northflank.usefulapi.io/mcpTools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
17 tools
Deletes or cancels 5Claude Code: deny
northflank_pause_serviceMUTATING: pause a service, scaling it to zero running instances.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it MUTATING: pause a service, scaling it to zero running instances. POST /v1/projects/{projectId}/services/{serviceId}/pause.
Annotations the server declares
- title: Pause service (mutates infra)
- destructiveHint: true
northflank_restart_serviceMUTATING: restart all running containers of a service.No findings
Why it is in this group
- The name "northflank_restart_service" says "restart": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it MUTATING: restart all running containers of a service. POST /v1/projects/{projectId}/services/{serviceId}/restart.
Annotations the server declares
- title: Restart service (mutates infra)
- destructiveHint: true
northflank_resume_serviceMUTATING: resume a paused service.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it MUTATING: resume a paused service. Optionally set the instance count and CI/CD/autoscaling state to restore. POST /v1/projects/{projectId}/services/{serviceId}/resume.
Annotations the server declares
- title: Resume service (mutates infra)
- destructiveHint: true
northflank_scale_serviceMUTATING: set the number of running instances (replicas) for a service.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it MUTATING: set the number of running instances (replicas) for a service. POST /v1/projects/{projectId}/services/{serviceId}/scale.
Annotations the server declares
- title: Scale service (mutates infra)
- destructiveHint: true
northflank_trigger_service_buildMUTATING: start a new build for a build/combined service.No findings
Why it is in this group
- The name "northflank_trigger_service_build" says "trigger": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it 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.
Annotations the server declares
- title: Trigger service build (mutates infra)
- destructiveHint: true
Only reads 12Claude Code: allow
northflank_get_addonGet details and status of a single addon.No findings
Why it is in this group
- The name "northflank_get_addon" says "get": a word for reading.
Description, as the server wrote it Get details and status of a single addon. GET /v1/projects/{projectId}/addons/{addonId}.
Annotations the server declares
- title: Get addon
- readOnlyHint: true
northflank_get_jobGet details of a single job, including build/deploy config and cron schedule.No findings
Why it is in this group
- The name "northflank_get_job" says "get": a word for reading.
Description, as the server wrote it Get details of a single job, including build/deploy config and cron schedule. GET /v1/projects/{projectId}/jobs/{jobId}.
Annotations the server declares
- title: Get job
- readOnlyHint: true
northflank_get_projectGet details of a single project, including region, cluster and associated services/jobs/addons.No findings
Why it is in this group
- The name "northflank_get_project" says "get": a word for reading.
Description, as the server wrote it Get details of a single project, including region, cluster and associated services/jobs/addons. GET /v1/projects/{projectId}.
Annotations the server declares
- title: Get project
- readOnlyHint: true
northflank_get_serviceGet details and current status of a single service.No findings
Why it is in this group
- The name "northflank_get_service" says "get": a word for reading.
Description, as the server wrote it Get details and current status of a single service. GET /v1/projects/{projectId}/services/{serviceId}.
Annotations the server declares
- title: Get service
- readOnlyHint: true
northflank_get_service_metricsGet CPU / memory metrics for a service's containers.No findings
Why it is in this group
- The name "northflank_get_service_metrics" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Get service metrics
- readOnlyHint: true
northflank_list_addonsList addons (managed databases / services) in a project with their status.No findings
Why it is in this group
- The name "northflank_list_addons" says "list": a word for reading.
Description, as the server wrote it List addons (managed databases / services) in a project with their status. GET /v1/projects/{projectId}/addons.
Annotations the server declares
- title: List addons
- readOnlyHint: true
northflank_list_domainsList custom domains for the account (or a team), with verification status.No findings
Why it is in this group
- The name "northflank_list_domains" says "list": a word for reading.
Description, as the server wrote it List custom domains for the account (or a team), with verification status. GET /v1/domains (team: GET /v1/teams/{teamId}/domains).
Annotations the server declares
- title: List domains
- readOnlyHint: true
northflank_list_jobsList jobs (manual / cron) in a project.No findings
Why it is in this group
- The name "northflank_list_jobs" says "list": a word for reading.
Description, as the server wrote it List jobs (manual / cron) in a project. GET /v1/projects/{projectId}/jobs.
Annotations the server declares
- title: List jobs
- readOnlyHint: true
northflank_list_projectsList projects for the authenticated token (or a specific team).No findings
Why it is in this group
- The name "northflank_list_projects" says "list": a word for reading.
Description, as the server wrote it 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).
Annotations the server declares
- title: List projects
- readOnlyHint: true
northflank_list_secret_groupsList a project's secret groups — METADATA ONLY (id, name, type, priority, restrictions).No findings
Why it is in this group
- The name "northflank_list_secret_groups" says "list": a word for reading.
Description, as the server wrote it List a project's secret groups — METADATA ONLY (id, name, type, priority, restrictions). Does NOT return secret values. GET /v1/projects/{projectId}/secrets.
Annotations the server declares
- title: List secret groups
- readOnlyHint: true
northflank_list_service_buildsList a build service's build runs / history (branch, sha, status, timestamps).No findings
Why it is in this group
- The name "northflank_list_service_builds" says "list": a word for reading.
Description, as the server wrote it List a build service's build runs / history (branch, sha, status, timestamps). GET /v1/projects/{projectId}/services/{serviceId}/build.
Annotations the server declares
- title: List service builds
- readOnlyHint: true
northflank_list_servicesList services in a project (build / deployment / combined) with their build+deployment status.No findings
Why it is in this group
- The name "northflank_list_services" says "list": a word for reading.
Description, as the server wrote it List services in a project (build / deployment / combined) with their build+deployment status. GET /v1/projects/{projectId}/services.
Annotations the server declares
- title: List services
- readOnlyHint: true
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 1.16.3. Values in angle brackets are yours to fill in.
claude mcp add --transport http northflank https://northflank.usefulapi.io/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__northflank__northflank_list_projects",
"mcp__northflank__northflank_get_project",
"mcp__northflank__northflank_list_services",
"mcp__northflank__northflank_get_service",
"mcp__northflank__northflank_list_jobs",
"mcp__northflank__northflank_get_job",
"mcp__northflank__northflank_list_addons",
"mcp__northflank__northflank_get_addon",
"mcp__northflank__northflank_list_service_builds",
"mcp__northflank__northflank_get_service_metrics",
"mcp__northflank__northflank_list_secret_groups",
"mcp__northflank__northflank_list_domains"
],
"ask": [],
"deny": [
"mcp__northflank__northflank_trigger_service_build",
"mcp__northflank__northflank_restart_service",
"mcp__northflank__northflank_scale_service",
"mcp__northflank__northflank_pause_service",
"mcp__northflank__northflank_resume_service"
]
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as northflank. Review it before you use it.