Northflank MCP server. Inspect and control your Northflank projects, services, jobs, and builds from your AI assistant.
Add to your MCP config, then reload & authorize:
{
"mcpServers": {
"northflank": {
"url": "https://northflank.usefulapi.io/mcp"
}
}
}| Tool | Type | What it does |
|---|---|---|
northflank_list_projects | read | List projects List the projects your API token can access (optionally scoped to a team) — call this first to discover the project ids that nearly every other tool requires. |
northflank_get_project | read | Get project Get a single project's full details, including its region, cluster, and the services, jobs, and addons it contains. |
northflank_list_services | read | List services List the services in a project — build, deployment, or combined — each with its current build and deployment status. |
northflank_get_service | read | Get service Get a single service's configuration and current runtime status. |
northflank_list_jobs | read | List jobs List the manual and cron jobs defined in a project. |
northflank_get_job | read | Get job Get a single job's details, including its build/deploy configuration and cron schedule. |
northflank_list_addons | read | List addons List the addons (managed databases and services) in a project along with each one's status. |
northflank_get_addon | read | Get addon Get a single addon's details and current status. |
northflank_list_service_builds | read | List service builds List a build service's build-run history, including branch, commit sha, status, and timestamps. |
northflank_get_service_metrics | read | Get service metrics Get CPU and memory metrics for a service's containers, as a point-in-time snapshot or a time-series range. |
northflank_list_secret_groups | read | List secret groups List a project's secret groups by metadata only (id, name, type, priority, restrictions) — never the secret values themselves. |
northflank_list_domains | read | List domains List the custom domains registered on the account or a team, each with its verification status. |
northflank_trigger_service_build | write | Trigger service build Start a new build for a build or combined service, optionally targeting a specific branch, commit sha, or pull request. |
northflank_restart_service | write | Restart service Restart all of a service's running containers. |
northflank_scale_service | write | Scale service Set the number of running instances (replicas) for a service. |
northflank_pause_service | write | Pause service Pause a service, scaling it down to zero running instances. |
northflank_resume_service | write | Resume service Resume a paused service, optionally restoring its instance count and CI/CD/autoscaling state. |
northflank_usage_status | Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter. | |
northflank_upgrade | Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED Northflank tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter. |
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 100 tool calls / month |
| Pro | $9/mo · $90/yr | Unlimited |
This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.