`estimate_vehicle`

Pack: carbon-interface · Endpoint: https://gateway.pipeworx.io/carbon-interface/mcp

Estimate CO2 emissions from driving a vehicle. Provide distance and a vehicle model ID (from Carbon Interface). Returns carbon emissions in grams, kg, and metric tons. Example: estimate_vehicle(100, “7268a9b7-17e8-4c8d-acca-57059252afe9”, “mi”).

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	Carbon Interface API key
`distance`	number	yes	Distance traveled (e.g., 100)
`vehicle_model_id`	string	yes	Carbon Interface vehicle model UUID
`unit`	string	no	Distance unit: “mi” or “km” (default: “mi”)

Example call

Arguments

{
  "_apiKey": "your-carbon-interface-api-key",
  "distance": 100,
  "vehicle_model_id": "7268a9b7-17e8-4c8d-acca-57059252afe9",
  "unit": "mi"
}

curl

curl -X POST https://gateway.pipeworx.io/carbon-interface/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"estimate_vehicle","arguments":{"_apiKey":"your-carbon-interface-api-key","distance":100,"vehicle_model_id":"7268a9b7-17e8-4c8d-acca-57059252afe9","unit":"mi"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('estimate_vehicle', {
  "_apiKey": "your-carbon-interface-api-key",
  "distance": 100,
  "vehicle_model_id": "7268a9b7-17e8-4c8d-acca-57059252afe9",
  "unit": "mi"
});

More examples

{
  "_apiKey": "your-carbon-interface-api-key",
  "distance": 50,
  "vehicle_model_id": "7268a9b7-17e8-4c8d-acca-57059252afe9",
  "unit": "km"
}

Response shape

Always returns: distance_value, distance_unit, vehicle_make, vehicle_model, vehicle_year, estimated_at, carbon_g, carbon_kg, carbon_mt, carbon_lb

Field	Type	Description
`distance_value`	number	Distance traveled
`distance_unit`	string	Distance unit (mi or km)
`vehicle_make`	string \| null	Vehicle manufacturer
`vehicle_model`	string \| null	Vehicle model name
`vehicle_year`	number \| null	Vehicle year of manufacture
`estimated_at`	string \| null	ISO timestamp of estimate
`carbon_g`	number \| null	Carbon emissions in grams
`carbon_kg`	number \| null	Carbon emissions in kilograms
`carbon_mt`	number \| null	Carbon emissions in metric tons
`carbon_lb`	number \| null	Carbon emissions in pounds

Full JSON Schema

{
  "type": "object",
  "properties": {
    "distance_value": {
      "type": "number",
      "description": "Distance traveled"
    },
    "distance_unit": {
      "type": "string",
      "description": "Distance unit (mi or km)"
    },
    "vehicle_make": {
      "type": [
        "string",
        "null"
      ],
      "description": "Vehicle manufacturer"
    },
    "vehicle_model": {
      "type": [
        "string",
        "null"
      ],
      "description": "Vehicle model name"
    },
    "vehicle_year": {
      "type": [
        "number",
        "null"
      ],
      "description": "Vehicle year of manufacture"
    },
    "estimated_at": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of estimate"
    },
    "carbon_g": {
      "type": [
        "number",
        "null"
      ],
      "description": "Carbon emissions in grams"
    },
    "carbon_kg": {
      "type": [
        "number",
        "null"
      ],
      "description": "Carbon emissions in kilograms"
    },
    "carbon_mt": {
      "type": [
        "number",
        "null"
      ],
      "description": "Carbon emissions in metric tons"
    },
    "carbon_lb": {
      "type": [
        "number",
        "null"
      ],
      "description": "Carbon emissions in pounds"
    }
  },
  "required": [
    "distance_value",
    "distance_unit",
    "vehicle_make",
    "vehicle_model",
    "vehicle_year",
    "estimated_at",
    "carbon_g",
    "carbon_kg",
    "carbon_mt",
    "carbon_lb"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "carbon-interface": {
      "url": "https://gateway.pipeworx.io/carbon-interface/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

estimate_vehicle