piercloud-mcp 0.3.4

MCP server for Pier Cloud - query cloud costs and optimization rules

Pier Cloud MCP Server

Connect your AI assistant to Pier Cloud data. Query cloud costs, analyze spending, and get insights using natural language.

What you can do

• Query AWS, Azure, and GCP cost data
• Analyze cloud spending patterns
• Get cost breakdowns by service, account, or time period
• All through natural conversation

Installation

# Install pipx if you don't have it
python3 -m pip install --user pipx
python3 -m pipx ensurepath

# Restart your terminal, then:
pipx install piercloud-mcp

# Or without restarting:
python3 -m pipx install piercloud-mcp

Setup for Claude Desktop

Easy way (recommended):

piercloud-mcp --install-claude

This will prompt for your credentials and configure Claude automatically.

Manual way:

1. Find the installation path:

which piercloud-mcp
# Output: /Users/yourname/.local/bin/piercloud-mcp (macOS/Linux)
# or C:\Users\yourname\.local\bin\piercloud-mcp.exe (Windows)

2. Add to Claude config with the full path:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "piercloud": {
      "command": "/Users/yourname/.local/bin/piercloud-mcp",
      "env": {
        "PIERCLOUD_CLIENT_ID": "your-client-id",
        "PIERCLOUD_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

3. Restart Claude Desktop

Setup for Amazon Q

piercloud-mcp --install-amazonq

This will prompt for your credentials and configure Amazon Q automatically. (Custom GPT)

1. Deploy the server:

# Set your credentials as environment variables
export PIERCLOUD_CLIENT_ID="your-client-id"
export PIERCLOUD_CLIENT_SECRET="your-client-secret"

# Run the server
piercloud-mcp --sse --port 8000 --host 0.0.0.0

2. Create a Custom GPT at https://chat.openai.com/gpts/editor

3. Configure Actions:

   • Import schema from: https://your-domain.com/openapi.json
   • Or manually add actions for each tool

4. Configure Authentication:

   • Type: Custom Headers
   • Header 1: X-Client-ID (user will provide their client ID)
   • Header 2: X-Client-Secret (user will provide their client secret)

5. Users will be prompted to enter their Pier Cloud credentials when first using the GPT