# northflank MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-usefulapi-northflank
- Repository: https://github.com/m190/usefulapi-mcp

## Install
- Endpoint: https://northflank.usefulapi.io/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://northflank.usefulapi.io/mcp

## Tools
- 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). Endpoint: https://northflank.usefulapi.io/mcp
- northflank_get_project (Get project) - Get details of a single project, including region, cluster and associated services/jobs/addons. GET /v1/projects/{projectId}. Endpoint: https://northflank.usefulapi.io/mcp
- northflank_list_services (List services) - List services in a project (build / deployment / combined) with their build+deployment status. GET /v1/projects/{projectId}/services. Endpoint: https://northflank.usefulapi.io/mcp
- northflank_get_service (Get service) - Get details and current status of a single service. GET /v1/projects/{projectId}/services/{serviceId}. Endpoint: https://northflank.usefulapi.io/mcp
- northflank_list_jobs (List jobs) - List jobs (manual / cron) in a project. GET /v1/projects/{projectId}/jobs. Endpoint: https://northflank.usefulapi.io/mcp
- northflank_get_job (Get job) - Get details of a single job, including build/deploy config and cron schedule. GET /v1/projects/{projectId}/jobs/{jobId}. Endpoint: https://northflank.usefulapi.io/mcp
- northflank_list_addons (List addons) - List addons (managed databases / services) in a project with their status. GET /v1/projects/{projectId}/addons. Endpoint: https://northflank.usefulapi.io/mcp
- northflank_get_addon (Get addon) - Get details and status of a single addon. GET /v1/projects/{projectId}/addons/{addonId}. Endpoint: https://northflank.usefulapi.io/mcp
- 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. Endpoint: https://northflank.usefulapi.io/mcp
- 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. Endpoint: https://northflank.usefulapi.io/mcp
- 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. Endpoint: https://northflank.usefulapi.io/mcp
- 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). Endpoint: https://northflank.usefulapi.io/mcp
- 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. Endpoint: https://northflank.usefulapi.io/mcp
- northflank_restart_service (Restart service (mutates infra)) - MUTATING: restart all running containers of a service. POST /v1/projects/{projectId}/services/{serviceId}/restart. Endpoint: https://northflank.usefulapi.io/mcp
- 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. Endpoint: https://northflank.usefulapi.io/mcp
- northflank_pause_service (Pause service (mutates infra)) - MUTATING: pause a service, scaling it to zero running instances. POST /v1/projects/{projectId}/services/{serviceId}/pause. Endpoint: https://northflank.usefulapi.io/mcp
- 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. Endpoint: https://northflank.usefulapi.io/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.usefulapi
- Version: 1.0.1
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 17, 2026
- Source: https://registry.modelcontextprotocol.io