MOCREO Public APIs and AI Skill
Build with MOCREO device data faster.
MOCREO Public APIs expose Smart System device, asset, history, export, and API key operations. The MOCREO Skill adds a natural-language layer on top of those APIs and the Sensor System tooling, so an AI agent can help with device data queries and product-use questions without making users memorize endpoint details.
MOCREO Smart System Public API URLs
Start here when integrating directly with the MOCREO Smart System public API.
-
Online OpenAPI documentation
https://api.mocreo.com/v1/public/openapi -
Smart System API base URL
https://api.mocreo.com/v1
What the MOCREO Skill Does
Routes requests
The root mocreo-api skill works as a router. It chooses the Smart System or Sensor System sub-skill based on the saved platform, app name, hub model, sensor model, asset wording, or API-key request.
Turns API work into plain language
Users can ask for battery levels, temperature, humidity, online status, alerts, historical readings, exports, asset details, device names, or API keys in natural language.
Guides product use
The skill also helps answer product-use questions by matching device families, system versions, supported operations, setup state, and common monitoring workflows.
Deployment Options
| Platform | Install command | Use case |
|---|---|---|
| skills.sh | npx skills add mocreo-iot/skills |
Install the source skill bundle directly. The root skill includes both Smart System and Sensor System routing. |
| Claude Plugin Marketplace | /plugin marketplace add mocreo-iot/skills/plugin install mocreo-api@mocreo-marketplace |
Install the packaged Claude plugin version for Claude Code marketplace workflows. |
python scripts/setup_credentials.py. The setup flow identifies the user's MOCREO system and stores credentials locally; users should never send passwords in chat.
How to Use It
1. Install
Install the skill through skills.sh or the Claude Plugin Marketplace, depending on the agent environment.
2. Set up credentials
Run python scripts/setup_credentials.py from the runtime root. The guided flow saves MOCREO_PLATFORM as the routing source of truth.
3. Ask naturally
Ask for device health, history, exports, alerts, asset operations, or API key tasks. The skill chooses the right system and scripts.
Supported Capabilities
| Capability | Smart System | Sensor System |
|---|---|---|
| Authentication | Login, token refresh, asset-scoped API key creation, listing, deletion, and local API key registry support. | OAuth login, token refresh, and current user lookup. |
| Device and asset operations | Assets, asset details, asset configuration, device list, device details, and device renaming. | Hub list, hub details, node list, node details, and node updates. |
| Monitoring data | Battery, online status, temperature, humidity, water leak, water level, frozen state, and signal data. | Node status, hub status, sensor readings, and alert-related data. |
| History and exports | Time-range history queries, aggregation windows, and email exports. | Node sample history with time filters, limits, and offsets. |
| Alerts and operations | Uses device status and history to help investigate abnormal conditions. | Alert listing, filtering, and dismiss-all workflows. |
Example Questions
Device health
"Check all device batteries and list anything below 20%." "Which sensors have been offline for more than an hour?"
Data and history
"Show the office temperature trend for the past 24 hours." "Export last week's temperature and humidity data to my email."
Operations
"Rename this sensor to Office-01." "Create a read-only API key for this asset." "Dismiss all pending alerts."