> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sensorup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Available MCP Tools

> Reference guide for SensorUp MCP tools and their capabilities

## Overview

SensorUp provides a set of MCP tools that enable AI assistants to interact with your SensorUp data and operations. Each tool is designed to perform specific tasks using the SensorUp GraphQL API.

## Core Tools

### Query Tool

Execute GraphQL queries against the SensorUp API.

**Capabilities:**

* Read asset data
* Query emission events
* Retrieve operational metrics
* Access user and organization information

**Input Parameters:**

* `query`: GraphQL query string
* `variables`: Optional query variables

**Example Usage:**
Ask your AI assistant: "Query my assets using the SensorUp MCP tool"

***

### Asset Tool

Retrieve and manage asset information.

**Capabilities:**

* List assets
* Get asset details
* Query asset status
* Access asset metadata

**Input Parameters:**

* `assetId`: Optional asset identifier
* `filters`: Optional filters for asset queries

**Example Usage:**
Ask your AI assistant: "Show me all my active assets"

***

### Event Tool

Access emission event data and analytics.

**Capabilities:**

* List emission events
* Get event details
* Query event statistics
* Access event timeline data

**Input Parameters:**

* `eventId`: Optional event identifier
* `dateRange`: Optional date range filter
* `status`: Optional event status filter

**Example Usage:**
Ask your AI assistant: "Show me emission events from the last 30 days"

***

## Data Tools

### Analytics Tool

Retrieve analytical insights and metrics.

**Capabilities:**

* Get summary statistics
* Query trend data
* Access dashboard metrics
* Generate custom reports

**Input Parameters:**

* `metricType`: Type of metric to query
* `dateRange`: Date range for analytics
* `groupBy`: Optional grouping parameter

**Example Usage:**
Ask your AI assistant: "Get emission trends for the last quarter"

***

## Tool Permissions

All MCP tools respect your SensorUp user permissions. Tools can only access data and perform operations that your API key is authorized for.

## Rate Limits

MCP tools are subject to the same rate limits as the SensorUp GraphQL API. See [Performance](/api/graphql/performance) for details.

## Tool Development

SensorUp MCP tools are built on the Model Context Protocol standard. For information about creating custom tools or extending existing ones, refer to the [MCP Official Documentation](https://modelcontextprotocol.io).

## Best Practices

1. **Be Specific**: Provide clear, specific requests to your AI assistant
2. **Use Filters**: Leverage filtering parameters to reduce response sizes
3. **Check Permissions**: Ensure your API key has appropriate permissions
4. **Monitor Usage**: Keep track of your API usage and rate limits

## Related Resources

* [Getting Started](/api/mcp/getting-started)
* [Usage Examples](/api/mcp/examples)
* [GraphQL API Reference](/api/graphql/overview)
* [Authentication](/api/graphql/authentication)