Metadata-Version: 2.1
Name: piercloud-mcp
Version: 0.3.5
Summary: MCP server for Pier Cloud - query cloud costs and optimization rules
Home-page: https://github.com/piercloud/piercloud-mcp
License: MIT
Keywords: mcp,model-context-protocol,ai,llm
Author: Pier Team
Author-email: engineering@piercloud.com
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: httpx (>=0.27.0,<0.28.0)
Requires-Dist: mcp (>=1.0.0,<2.0.0)
Requires-Dist: pydantic (>=2.0.0,<3.0.0)
Requires-Dist: starlette (>=0.37.0,<0.38.0)
Requires-Dist: uvicorn (>=0.30.0,<0.31.0)
Project-URL: Repository, https://github.com/piercloud/piercloud-mcp
Description-Content-Type: text/markdown

# 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

```bash
# 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):

```bash
piercloud-mcp --install-claude
```

This will prompt for your credentials and configure Claude automatically.

**Manual way**:

1. Find the installation path:

```bash
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`

```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

```bash
piercloud-mcp --install-amazonq
```

This will prompt for your credentials and configure Amazon Q automatically.

## Setup for AWS Kiro

```bash
piercloud-mcp --install-kiro
```

This will prompt for your credentials and configure AWS Kiro automatically. (Custom GPT)

1. Deploy the server:

```bash
# 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

