Metadata-Version: 2.4
Name: costlens-mcp
Version: 1.0.0
Summary: FinOps MCP Server for BigQuery - Cost estimation, query optimization, and safe execution
Project-URL: Homepage, https://github.com/elie00/costlens
Project-URL: Documentation, https://github.com/elie00/costlens#readme
Project-URL: Repository, https://github.com/elie00/costlens
Author: CostLens Team
License-Expression: MIT
Keywords: ai,bigquery,cost,estimation,finops,llm,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Requires-Dist: google-cloud-bigquery>=3.20.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: sqlglot>=20.0.0
Description-Content-Type: text/markdown

# CostLens MCP

**FinOps MCP Server for BigQuery** — Cost estimation, query optimization, and safe execution.

## Installation

```bash
# Via pip
pip install costlens-mcp

# Via uvx (recommended)
uvx costlens-mcp --project YOUR_PROJECT
```

## Quick Start

```bash
# If you've run `gcloud auth application-default login`
costlens-mcp --project my-project

# With service account
costlens-mcp --project my-project --key-file /path/to/key.json

# Enable query execution (with cost limit)
costlens-mcp --project my-project --allow-execute --max-cost 5.0
```

## Tools

| Tool | Description |
|------|-------------|
| `estimate_query_cost` | Precise cost via BigQuery dry-run |
| `list_tables` | Tables with sizes |
| `describe_table` | Schema + partitions |
| `execute_query` | Cost-gated execution |
| `get_optimizations` | Structured suggestions |

## MCP Configuration

```json
{
  "mcpServers": {
    "costlens": {
      "command": "uvx",
      "args": ["costlens-mcp", "--project", "YOUR_PROJECT"]
    }
  }
}
```

## License

MIT
