A NitroStack MCP server that turns "push this" and "deploy this" into one conversation.
Connect it to any MCP-compatible AI agent (Claude, ChatGPT, Gemini, and others) and give it the ability to read your repos, commit code, open PRs, wire up CI, and ship to Vercel, Netlify, Cloudflare Pages, or Render — without you ever leaving the chat.
- GitHub PAT and OAuth (device-code + browser redirect) authentication with account verification
- Create, list, and look up repositories
- Read trees, files, and directories; search code across a repo
repo_onboarding_summary— one call to detect the tech stack, surface the important files, and suggest safe next steps in a new repo
- Create and delete branches
- List commit history
- Commit single or multiple files, update branch refs
- Create, list, and merge pull requests
apply_code_patch— the tool behind "push/save/commit this code for me"create_feature_branch_and_pr— branch → commit → PR in one workflow
- Repository analyzer detects framework, language, and package manager automatically
prepare_deploy_plan— checks deploy readiness, generates build/start commands and a Dockerfilesetup_ci_deployment_gate— generates stack-aware GitHub Actions CI that gates deployment on passing tests
| Provider | Tool | Integration |
|---|---|---|
| Vercel | deploy_to_vercel |
Git integration |
| Netlify | deploy_to_netlify |
Git integration |
| Cloudflare Pages | deploy_to_cloudflare_pages |
Git integration |
| Render | render_list_services, render_trigger_deploy, render_get_deploy_status |
Service integration |
safe_deployment_pipeline— a strict, best-practice sequence: check repo structure → ensure containerization → set up test-gated CI → trigger deploy
Rich UI rendered straight into the agent conversation:
- Calculator Result — shows the operation, operands, and result of a calculation
- Deployment Status — live status, logs, and links for a running deployment
Built on @nitrostack/core and @nitrostack/cli, with TypeScript, Zod schema validation, and @modelcontextprotocol/ext-apps for the widget layer.
No credentials are required just to start the server. Add the following depending on which features you want to enable.
Can be set as environment variables, or passed dynamically in the tool payload itself:
VERCEL_TOKEN=... # Vercel Personal Access Token
NETLIFY_TOKEN=... # Netlify Personal Access Token
CLOUDFLARE_API_TOKEN=... # Cloudflare API Token
RENDER_API_KEY=rnd_... # Required for Render integrationRequired only if you want the interactive browser OAuth flow:
GITHUB_OAUTH_CLIENT_ID=your_github_oauth_app_client_id
GITHUB_OAUTH_CLIENT_SECRET=your_github_oauth_app_client_secret
# Required unless NITROSTACK_PUBLIC_URL is provided by the platform
RESOURCE_URI=https://your-app.nitrocloud.appYour GitHub OAuth App's callback URL must be:
https://your-app.nitrocloud.app/auth/github/callback
Override it explicitly with GITHUB_OAUTH_REDIRECT_URI if needed.
GITHUB_TOKEN=your_github_personal_access_tokenThe dynamic user token created by
authenticate_githubis session-based — never hardcode it as an environment variable.
AUTH_SERVER_URL=https://github.com
OAUTH_REQUIRED=false
HOST=0.0.0.0Only set OAUTH_REQUIRED=true after configuring JWKS_URI or the introspection variables.
Browser login
- Call
authenticate_githubwith{ "action": "browser_start" } - Open
authorization_urland approve access - Call
authenticate_githubwith{ "action": "browser_poll", "state": "..." }untilstatusisauthenticated
Device-code login
- Call
authenticate_githubwith{ "action": "start" } - Open
verification_uriand enteruser_code - Call
authenticate_githubwith{ "action": "poll", "device_code": "..." }untilstatusisauthenticated
npm run devnpm run buildnpm run startAdd your license here.