# Caterpillar Cat Digital AI Agent Connect

> Caterpillar Cat Digital MCP connects your AI client directly to the api.cat.com gateway. It gives your agent access to live diagnostic events, fault codes, and telemetry usage records from your connected Cat machine fleet. Use it to monitor machine health and track data consumption against your subscription limits.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_3LmUMyuqRxc2EQVhDV2rCghJ2mZfTzV3rZAOuLWj/ai-agent-connect
- **Tags:** caterpillar, visionlink, heavy-equipment, telematics, construction-tech, equipment-diagnostics

## Description

This MCP acts as a direct bridge to the Caterpillar Cat Digital API gateway. Instead of manually checking portals, you can ask your AI client to pull diagnostic data or check how much telemetry data your fleet has consumed. It uses Bearer authentication from the Cat Developer Program to securely pull information from your connected machines. You can use it to identify fault codes, monitor machine health, and keep an eye on your telemetry billing to avoid exceeding plan limits. It is built for anyone managing heavy equipment who wants to automate data analysis or build custom monitoring tools using an AI agent.

## Tools

### get_telemetry_billing
This tool retrieves telemetry billing records for your Cat equipment. It helps you monitor how much data your machines are using against your specific plan limits.

### get_diagnostics_services
This tool pulls diagnostic events and fault codes from connected Cat machines. It provides the raw diagnostic data needed to troubleshoot equipment issues through your AI client.

### get_ai_assistant_config
This tool accesses the public configuration for the Cat Digital AI assistant. It provides guest access to the configuration settings used by the Cat AI assistant.

## Prompt Examples

**Prompt:** 
```
Show me diagnostic events from my Cat machines
```

**Response:** 
```
Cat Diagnostic Services: Recent diagnostic events from your connected fleet: D6T Dozer (S/N ABC123): Fault code 4592-14, aftertreatment. 320 Excavator (S/N DEF456): Sensor reading event, hydraulic temp. Each event includes machine S/N, code and timestamp.
```

**Prompt:** 
```
How much telemetry data usage have we billed this month?
```

**Response:** 
```
Telemetry billing (Cat Digital): Current cycle shows X GB across N machines, which is within your plan allowance. A per-machine breakdown is included in the payload.
```

**Prompt:** 
```
Check if any machines have active fault codes
```

**Response:** 
```
Cat Diagnostic Services: I found one active fault code. D6T Dozer (S/N ABC123) is reporting fault code 4592-14 related to the aftertreatment system.
```

## Capabilities

### Machine Diagnostics
Your agent pulls fault codes and diagnostic events directly from connected machines.

### Usage Monitoring
The AI checks telemetry billing records to track data consumption.

### Configuration Access
Your client retrieves public configuration settings for the Cat Digital AI assistant.

## Use Cases

### Fleet Health Audits
An AI agent scans all connected machines for active fault codes to identify maintenance needs.

### Data Budgeting
You check telemetry billing to ensure job site connectivity isn't driving up data costs.

### Automated Troubleshooting
Your AI client interprets diagnostic events to suggest immediate repair steps for technicians.

### Subscription Management
Monitor API consumption to stay within the limits of your Cat Digital developer plan.

## Benefits

- Direct access to api.cat.com via Bearer authentication.
- Automated monitoring of telemetry usage against subscription limits.
- Instant retrieval of machine fault codes and diagnostic events.
- Eliminates manual lookups in the Cat Digital portal.

## How It Works

Connecting to Caterpillar data is a straightforward process once you have your developer credentials.

1. Apply for access through the Cat Digital Developer Program.
2. Obtain your Bearer access tokens for your subscribed products.
3. Paste your token into the MCP credentials section in Vinkius.
4. Connect your preferred AI client to the Vinkius host.
5. Ask your AI agent to pull diagnostics or billing data.

## Frequently Asked Questions

**How do I authenticate this MCP?**
You must use a Bearer token obtained from the Cat Digital Developer Program. You paste this token into the credentials tab of the MCP in Vinkius.

**What should I do if I get a 401.006 error?**
A 401.006 error indicates that your Bearer token is either missing or invalid. Check your credentials in the Vinkius settings.

**Can I use this to check my data usage?**
Yes, the get_telemetry_billing tool allows you to monitor your telemetry data usage against your plan limits.

**What if the tool says I lack a product subscription?**
If you receive a 403 error, it means your Cat Digital app does not have the specific product subscription required for that tool.

**Which AI clients can use this MCP?**
This MCP works with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.

**How do I get the access token?**
Apply to the Cat Digital Developer Program (through Caterpillar's digital team / your dealer). After app approval you receive Bearer tokens scoped to your subscribed products (Diagnostics, Telemetry). The token is sent as Authorization: Bearer on every call.

**I get 401.006 — what does it mean?**
Apigee code 401.006 = 'Missing Authorization header or token value' — the Bearer token was not sent or is invalid/expired. 400.006 = missing required fields in the request; 404.001 = wrong path.