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
generate_suggestions	Get 4 tier options (Starter/MVP/Startup/Enterprise) with monthly costs
get_pricing	Detailed cost breakdown for individual cloud resources
detect_region	Detect configured AWS/GCP/Azure/Oracle region
detect_providers	Detect all configured cloud providers
list_credentials	Check cloud credential configuration
deploy	Provision infrastructure via the Execution API
get_deployment_status	Check deployment progress
destroy	Tear down a specific deployment
list_deployments	List all tracked deployments
teardown_latest	Destroy most recent active deployment
get_balance	Check account credit balance
top_up	Add credits (XRP or Stripe)

Typical Flow

1. detect_region          → Get your AWS region
2. generate_suggestions   → 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                 → 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, destroy, top_up). Read operations (generate_suggestions, get_pricing, detect_region) work without a token.

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