Skip to content

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.

Deletes · 5

17 tools: 5 can delete or cancel things and 12 only read.

Scanned Oct 21, 2026

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/mcp

Tools

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/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.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.