Skip to main content

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.

​
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 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.

​
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