# Northflank MCP by usefulapi

> Northflank MCP by usefulapi is an MCP server. Inspect and control your Northflank projects, services, jobs, and builds from your AI assistant. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/northflank/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/northflank
- **MCP Registry name:** io.usefulapi/northflank
- **Listing updated:** 2026-11-13

## About

Inspect and control your Northflank projects, services, jobs, and builds from your AI assistant.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http northflank https://northflank.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://northflank.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "northflank": {
      "url": "https://northflank.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "northflank": {
      "type": "http",
      "url": "https://northflank.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "northflank": {
      "serverUrl": "https://northflank.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "northflank": {
      "type": "http",
      "url": "https://northflank.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `northflank_list_repositories`: List GitHub repositories accessible through Northflank's linked GitHub accounts, with repository URLs and account logins for northflank_create_combined_service. Does not connect a new GitHub account. GET /v1/integrations/vcs/repos.
- `northflank_list_plans`: List Northflank deployment plan IDs, CPU, RAM and vendor prices. Choose an explicit deploymentPlan for northflank_create_combined_service; these are Northflank infrastructure charges, separate from UsefulAPI. GET /v1/plans.
- `northflank_create_combined_service`: MUTATING: create a combined service that builds a connected GitHub repository and deploys it. May incur Northflank build/compute charges and expose the selected HTTP port publicly. Confirm the repository, branch, plan, port and inherited-secret access with the user, then pass confirm=true. Supply absolute Dockerfile/context paths. environmentSecretReferences maps runtime variable names to existing
- `northflank_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).
- `northflank_get_project`: Get details of a single project, including region, cluster and associated services/jobs/addons. GET /v1/projects/{projectId}.
- `northflank_list_services`: List services in a project (build / deployment / combined) with their build+deployment status. GET /v1/projects/{projectId}/services.
- `northflank_get_service`: Get details and current status of a single service. GET /v1/projects/{projectId}/services/{serviceId}.
- `northflank_list_jobs`: List jobs (manual / cron) in a project. GET /v1/projects/{projectId}/jobs.
- `northflank_get_job`: Get details of a single job, including build/deploy config and cron schedule. GET /v1/projects/{projectId}/jobs/{jobId}.
- `northflank_list_addons`: List addons (managed databases / services) in a project with their status. GET /v1/projects/{projectId}/addons.
- `northflank_get_addon`: Get details and status of a single addon. GET /v1/projects/{projectId}/addons/{addonId}.
- `northflank_list_service_builds`: List a build service's build runs / history (branch, sha, status, timestamps). GET /v1/projects/{projectId}/services/{serviceId}/build.
- `northflank_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.
- `northflank_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.
- `northflank_list_domains`: List custom domains for the account (or a team), with verification status. GET /v1/domains (team: GET /v1/teams/{teamId}/domains).
- `northflank_trigger_service_build`: 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.
- `northflank_restart_service`: MUTATING: restart all running containers of a service. POST /v1/projects/{projectId}/services/{serviceId}/restart.
- `northflank_scale_service`: MUTATING: set the number of running instances (replicas) for a service. POST /v1/projects/{projectId}/services/{serviceId}/scale.
- `northflank_pause_service`: MUTATING: pause a service, scaling it to zero running instances. POST /v1/projects/{projectId}/services/{serviceId}/pause.
- `northflank_resume_service`: MUTATING: resume a paused service. Optionally set the instance count and CI/CD/autoscaling state to restore. POST /v1/projects/{projectId}/services/{serviceId}/resume.

## FAQ

### How do I add Northflank MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http northflank https://northflank.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/northflank-mcp-by-usefulapi
