Provision Stack MCP

Cloud infrastructure provisioning via natural language. Deploy production-ready infrastructure on your own AWS, GCP, Azure, or Oracle account with a single prompt.

Quick Start

Remote (recommended)

Point your MCP client directly at the hosted API — no local process needed:

{
  "mcpServers": {
    "provision-stack": {
      "url": "https://api.provision-stack.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Get a token: curl -X POST https://api.provision-stack.com/auth/tokens -H 'Content-Type: application/json' -d '{"agentId":"your-agent","scopes":[]}'

Local stdio (via npx)

npx @provision-stack/mcp

Or add to your MCP client config:

{
  "mcpServers": {
    "provision-stack": {
      "command": "npx",
      "args": ["-y", "@provision-stack/mcp"],
      "env": {
        "PROVISION_STACK_API_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Install globally

npm install -g @provision-stack/mcp
provision-stack-mcp

Tools (12)

| Tool | Purpose | |------|---------| | suggestions.generate | Get 4 tier options (Starter/MVP/Startup/Enterprise) with monthly costs | | pricing.get | Detailed cost breakdown for individual cloud resources | | region.detect | Detect configured AWS/GCP/Azure/Oracle region | | providers.detect | Detect all configured cloud providers | | credentials.list | Check cloud credential configuration | | deploy.run | Provision infrastructure via the Execution API | | deploy.status | Check deployment progress | | deploy.destroy | Tear down a specific deployment | | deploy.list | List all tracked deployments | | deploy.teardown_latest | Destroy most recent active deployment | | billing.balance | Check account credit balance | | billing.top_up | Add credits (XRP or Stripe) |

Typical Flow

1. region.detect          → Get your AWS region
2. suggestions.generate   → Get 4 tier options with costs
3. Present options        → Show costs, resources, tradeoffs
4. WAIT for user choice   → Never proceed without explicit selection
5. deploy.run             → Provision infrastructure
6. Report results         → Deployment ID, resources, costs

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | PROVISION_STACK_EXECUTION_API_URL | API base URL | https://api.provision-stack.com | | PROVISION_STACK_API_TOKEN | Bearer token | (none — read-only tools work without) | | AWS_REGION | AWS region override | ~/.aws/config or us-east-1 | | AWS_PROFILE | AWS profile name | default |

Architecture

This package is a thin client — it defines MCP tools and forwards calls to the hosted Execution API. All business logic (pattern matching, pricing, Terraform generation, verification) runs server-side.

Your AI Client → MCP stdio/HTTP → This Package → Execution API → Your AWS Account

The API endpoint requires authentication for write operations (deploy.run, deploy.destroy, billing.top_up). Read operations (suggestions.generate, pricing.get, region.detect) work without a token.

Pre-0.5.0 underscore names still work on tools/call (e.g. generate_suggestions → suggestions.generate); tools/list advertises only the dotted names.

Links

• API: https://api.provision-stack.com
• Website: https://provision-stack.com
• Docs: https://provision-stack.com/llms.txt
• Issues: https://github.com/TravisLinkey/provision-stack-mcp/issues

License

MIT