# BoaviztAPI

> BoaviztAPI is an open-source MCP server for cloud and infrastructure. Estimate the carbon footprint of cloud instances, servers, GPUs and devices. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Repository:** https://github.com/malikmalikayesha/boaviztapi-mcp
- **MCP Registry name:** io.github.malikmalikayesha/boaviztapi-mcp
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-14

## About

Footprint figures come from BoaviztAPI, built by Boavizta, and the server reports them with units, uncertainty ranges and caveats. It is an unofficial community project. Embedded impact (manufacturing) and use-phase impact (electricity) are always reported separately, with a total only when both exist, and a figure that BoaviztAPI cannot supply is shown as not available rather than zero. Defaults cover climate change (gwp), mineral and fossil resource use (adp) and primary energy (pe).

Eight read-only tools handle the work: list_impact_criteria, search_catalog, describe_catalog_item, estimate_cloud_instance, estimate_server, estimate_component, estimate_device and compare_estimates, which ranks two to five options and says when ranges overlap. Names are matched carefully, so a vague name such as h100 returns candidates instead of a silent guess.

It runs locally over stdio via uvx, Docker or from source and needs uv. By default it queries the public BoaviztAPI demo instance; the README recommends running your own with the Boavizta Docker image and setting BOAVIZTAPI_URL for regular use. Responses are cached for a day by default.

## Features

- **Cloud instance estimates:** Footprint of one cloud VM by provider, instance type, region and load.
- **Server and GPU estimates:** Estimate an on-premise server, optionally with GPUs, or a single component.
- **Device estimates:** Cover laptops, phones, monitors, IoT devices and other end-user hardware.
- **Side-by-side comparison:** Rank two to five options over the same period and flag overlapping ranges.
- **Careful name matching:** Ambiguous names are refused with a candidate list instead of being guessed.
- **Self-hostable backend:** Point it at your own BoaviztAPI instance and tune timeout, criteria and caching.

## Good for

- Estimate the footprint of 4 H100 GPUs running a year in Germany
- Compare an AWS instance across regions
- Find the embedded carbon of a typical laptop
- Rank two instance types by climate impact
- Look up what an impact criterion such as adp means

## Install

### Claude Code (Terminal)

```sh
claude mcp add boaviztapi-mcp -- uvx boaviztapi-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "boaviztapi-mcp": {
      "command": "uvx",
      "args": [
        "boaviztapi-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "boaviztapi-mcp": {
      "command": "uvx",
      "args": [
        "boaviztapi-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "boaviztapi-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "boaviztapi-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "boaviztapi-mcp": {
      "command": "uvx",
      "args": [
        "boaviztapi-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "boaviztapi-mcp": {
      "command": "uvx",
      "args": [
        "boaviztapi-mcp"
      ]
    }
  }
}
```

## Tools

- `list_impact_criteria`: Explains impact criteria codes and their units.
- `search_catalog`: Finds exact catalogue names before estimating.
- `describe_catalog_item`: Shows what an instance, archetype, GPU or CPU contains.
- `estimate_cloud_instance`: Estimates the footprint of one cloud VM.
- `estimate_server`: Estimates the footprint of an on-premise server, optionally with GPUs.
- `estimate_component`: Estimates the footprint of one GPU, CPU, RAM module, SSD or HDD.
- `estimate_device`: Estimates the footprint of a laptop, phone, monitor or other device.
- `compare_estimates`: Ranks two to five options over the same period.

## FAQ

### Where do the numbers come from?

Every number comes from BoaviztAPI by Boavizta; the server is an unofficial community project.

### Can I change something with it?

No. All tools are read-only.

### Which instance does it query?

The public BoaviztAPI demo by default; set BOAVIZTAPI_URL to use your own.

### How do I install it?

Run it with uvx boaviztapi-mcp, with Docker, or from source; uv is required.

### Are results cached?

Lists and lookups are cached for 86400 seconds by default; set the TTL to 0 to disable.

### Is BoaviztAPI free?

Yes. BoaviztAPI is open source, so you can use and self-host it for free.

### How do I add BoaviztAPI to Claude Code?

Run this command in your terminal: claude mcp add boaviztapi-mcp -- uvx boaviztapi-mcp

### What are the best alternatives to BoaviztAPI?

The closest alternatives to BoaviztAPI are GridHop GPU Price & Carbon Index, TheAIMeters, GreenPick, AI Footprint and CloudCostAI.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [GridHop GPU Price & Carbon Index](https://ai-powered.com/mcp/gridhop-gpu-price-and-carbon-index): GridHop GPU Price & Carbon Index is an open-source MCP server for cloud and infrastructure.
- [TheAIMeters](https://ai-powered.com/mcp/theaimeters): TheAIMeters is a free MCP server for analytics and data.
- [GreenPick](https://ai-powered.com/mcp/greenpick): GreenPick is an MCP server for cloud and infrastructure.
- [AI Footprint](https://ai-powered.com/mcp/ai-footprint): AI Footprint is an open-source MCP server for ai models and llm tooling.
- [CloudCostAI](https://ai-powered.com/mcp/cloudcostai): CloudCostAI is a freemium MCP server for cloud and infrastructure.
- [Lead Green](https://ai-powered.com/mcp/lead-green): Lead Green is an open-source MCP server for ai models and llm tooling.
- [GreenOps Scan](https://ai-powered.com/mcp/greenops-scan): GreenOps Scan is a free MCP server for cloud and infrastructure.
- [Greener Ahead](https://ai-powered.com/mcp/greener-ahead): Greener Ahead is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/boaviztapi
