Read Adafruit IO feeds, data, groups and dashboards; publish a data point or create a feed.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
WRITE: create a new, empty feed (private by default), optionally inside an existing group. Adds a feed only; it does not change or delete anything existing, and fails if the name is taken. POST /feeds.
Feed name (the key is derived from it).
Optional existing group key to create the feed in.
Optional description.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
WRITE: create a new, empty feed (private by default), optionally inside an existing group. Adds a feed only; it does not change or delete anything existing, and fails if the name is taken. POST /feeds.
| Argument | Type | Description |
|---|---|---|
| name* | string | Feed name (the key is derived from it). |
| group_key | string | Optional existing group key to create the feed in. |
| description | string | Optional description. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Feed name (the key is derived from it)."
},
"group_key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Optional existing group key to create the feed in."
},
"description": {
"type": "string",
"maxLength": 1000,
"description": "Optional description."
}
}
}One dashboard by key. GET /dashboards/{dashboard_key}.
| Argument | Type | Description |
|---|---|---|
| dashboard_key* | string | Dashboard key. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dashboard_key"
],
"properties": {
"dashboard_key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Dashboard key."
}
}
}One stored data point of a feed by its id. GET /feeds/{feed_key}/data/{id}.
| Argument | Type | Description |
|---|---|---|
| data_id* | string | Data point id (the `id` field of a data point). |
| feed_key* | string | Feed key (the URL-safe key shown in Adafruit IO, for example 'temperature'; 'group-key.feed-key' also works). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"feed_key",
"data_id"
],
"properties": {
"data_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Data point id (the `id` field of a data point)."
},
"feed_key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Feed key (the URL-safe key shown in Adafruit IO, for example 'temperature'; 'group-key.feed-key' also works)."
}
}
}One feed by key: name, description, unit, visibility, last value, status settings and the groups it belongs to. GET /feeds/{feed_key}.
| Argument | Type | Description |
|---|---|---|
| feed_key* | string | Feed key (the URL-safe key shown in Adafruit IO, for example 'temperature'; 'group-key.feed-key' also works). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"feed_key"
],
"properties": {
"feed_key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Feed key (the URL-safe key shown in Adafruit IO, for example 'temperature'; 'group-key.feed-key' also works)."
}
}
}Aggregated chart data for a feed: values sliced by `resolution` minutes over the last `hours` (or a start/end range), using avg, sum, min, max, val or val_count. Good for trends without downloading every point. GET /feeds/{feed_key}/data/chart.
| Argument | Type | Description |
|---|---|---|
| field | string | Aggregation (default avg). |
| hours | integer | Hours of history (ignored when start_time and end_time are given). |
| end_time | string | ISO 8601 date or date-time, e.g. 2026-10-01T00:00:00Z. |
| feed_key* | string | Feed key (the URL-safe key shown in Adafruit IO, for example 'temperature'; 'group-key.feed-key' also works). |
| resolution | any | Slice size in minutes. |
| start_time | string | ISO 8601 date or date-time, e.g. 2026-10-01T00:00:00Z. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"feed_key"
],
"properties": {
"field": {
"enum": [
"avg",
"sum",
"val",
"min",
"max",
"val_count"
],
"type": "string",
"description": "Aggregation (default avg)."
},
"hours": {
"type": "integer",
"maximum": 8760,
"minimum": 1,
"description": "Hours of history (ignored when start_time and end_time are given)."
},
"end_time": {
"type": "string",
"description": "ISO 8601 date or date-time, e.g. 2026-10-01T00:00:00Z."
},
"feed_key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Feed key (the URL-safe key shown in Adafruit IO, for example 'temperature'; 'group-key.feed-key' also works)."
},
"resolution": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 5
},
{
"type": "number",
"const": 10
},
{
"type": "number",
"const": 30
},
{
"type": "number",
"const": 60
},
{
"type": "number",
"const": 120
},
{
"type": "number",
"const": 240
},
{
"type": "number",
"const": 480
},
{
"type": "number",
"const": 960
}
],
"description": "Slice size in minutes."
},
"start_time": {
"type": "string",
"description": "ISO 8601 date or date-time, e.g. 2026-10-01T00:00:00Z."
}
}
}A feed with its details block: first and last data point and the number of stored points. GET /feeds/{feed_key}/details.
| Argument | Type | Description |
|---|---|---|
| feed_key* | string | Feed key (the URL-safe key shown in Adafruit IO, for example 'temperature'; 'group-key.feed-key' also works). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"feed_key"
],
"properties": {
"feed_key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Feed key (the URL-safe key shown in Adafruit IO, for example 'temperature'; 'group-key.feed-key' also works)."
}
}
}One group by key with its feeds. GET /groups/{group_key}.
| Argument | Type | Description |
|---|---|---|
| group_key* | string | Group key. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"group_key"
],
"properties": {
"group_key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Group key."
}
}
}The most recent data point of a feed (value, location, created_at). GET /feeds/{feed_key}/data/last.
| Argument | Type | Description |
|---|---|---|
| include | string | Comma-separated fields to return: value, lat, lon, ele, id, created_at. |
| feed_key* | string | Feed key (the URL-safe key shown in Adafruit IO, for example 'temperature'; 'group-key.feed-key' also works). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"feed_key"
],
"properties": {
"include": {
"type": "string",
"pattern": "^(value|lat|lon|ele|id|created_at)(,(value|lat|lon|ele|id|created_at))*$",
"description": "Comma-separated fields to return: value, lat, lon, ele, id, created_at."
},
"feed_key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Feed key (the URL-safe key shown in Adafruit IO, for example 'temperature'; 'group-key.feed-key' also works)."
}
}
}The account's data rate limit (data-record modifications per minute: 30 on free accounts, 60 on Plus) and the current active data rate. Check it before publishing many points. GET /api/v2/{username}/throttle.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}The Adafruit IO account this key belongs to: id, name, username, time zone, created/updated times, plus the data rate limit when reported. GET /api/v2/user.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}The account's activity log (feed/data/dashboard changes), optionally within a time range. GET /activities.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum entries, 1-1000. |
| end_time | string | ISO 8601 date or date-time, e.g. 2026-10-01T00:00:00Z. |
| start_time | string | ISO 8601 date or date-time, e.g. 2026-10-01T00:00:00Z. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Maximum entries, 1-1000."
},
"end_time": {
"type": "string",
"description": "ISO 8601 date or date-time, e.g. 2026-10-01T00:00:00Z."
},
"start_time": {
"type": "string",
"description": "ISO 8601 date or date-time, e.g. 2026-10-01T00:00:00Z."
}
}
}The blocks (widgets: gauges, toggles, charts, sliders...) of a dashboard with their feeds, position and properties. Integration secrets in properties are removed. GET /dashboards/{dashboard_key}/blocks.
| Argument | Type | Description |
|---|---|---|
| dashboard_key* | string | Dashboard key. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dashboard_key"
],
"properties": {
"dashboard_key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Dashboard key."
}
}
}List the account's dashboards with key, name, description and visibility. GET /dashboards.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Data points of a feed (max 1000 per call). Newest first, except that with start_time the API returns the oldest page after that time. Filter by time range and limit; to read further back call again with the reply's next_page_args (the same filters plus `before`). GET /feeds/{feed_key}/data.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum records to return, 1-1000 (default 100). |
| before | string | Pagination token: next_before from the previous reply (keep the same other arguments). |
| include | string | Comma-separated fields to return: value, lat, lon, ele, id, created_at. |
| end_time | string | ISO 8601 date or date-time, e.g. 2026-10-01T00:00:00Z. |
| feed_key* | string | Feed key (the URL-safe key shown in Adafruit IO, for example 'temperature'; 'group-key.feed-key' also works). |
| start_time | string | ISO 8601 date or date-time, e.g. 2026-10-01T00:00:00Z. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"feed_key"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Maximum records to return, 1-1000 (default 100)."
},
"before": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Pagination token: next_before from the previous reply (keep the same other arguments)."
},
"include": {
"type": "string",
"pattern": "^(value|lat|lon|ele|id|created_at)(,(value|lat|lon|ele|id|created_at))*$",
"description": "Comma-separated fields to return: value, lat, lon, ele, id, created_at."
},
"end_time": {
"type": "string",
"description": "ISO 8601 date or date-time, e.g. 2026-10-01T00:00:00Z."
},
"feed_key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Feed key (the URL-safe key shown in Adafruit IO, for example 'temperature'; 'group-key.feed-key' also works)."
},
"start_time": {
"type": "string",
"description": "ISO 8601 date or date-time, e.g. 2026-10-01T00:00:00Z."
}
}
}List all of the account's feeds with key, name, description, unit, visibility, enabled flag, last value and last update. GET /feeds.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}List the account's groups (named sets of feeds) with their feeds. GET /groups.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}WRITE: publish one data point (a value) to a feed. This can drive REAL DEVICES: anything subscribed to the feed (relays, motors, lights, heaters, locks, dashboard toggles) will receive and may act on the value, and it cannot be undone from here. Only publish a value the user has asked for. Counts against the account's data rate limit (30 per minute on free accounts, 60 on Plus). POST /feeds/{feed_key}/data.
| Argument | Type | Description |
|---|---|---|
| ele | number | Elevation of the reading in meters. |
| lat | number | Latitude of the reading. |
| lon | number | Longitude of the reading. |
| value* | any | The value to publish (text or number, up to 1000 characters). |
| feed_key* | string | Feed key (the URL-safe key shown in Adafruit IO, for example 'temperature'; 'group-key.feed-key' also works). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"feed_key",
"value"
],
"properties": {
"ele": {
"type": "number",
"maximum": 100000,
"minimum": -20000,
"description": "Elevation of the reading in meters."
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude of the reading."
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude of the reading."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "number"
}
],
"description": "The value to publish (text or number, up to 1000 characters)."
},
"feed_key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Feed key (the URL-safe key shown in Adafruit IO, for example 'temperature'; 'group-key.feed-key' also works)."
}
}
}