AWS IoT Core

io.github.nagarjunrPublished by GitHub account nagarjunrv0.1.0Updated Oct 24, 2026

MCP server for AWS IoT Core: device registry, shadows, jobs, rules, messaging.

The publisher's own server: core.blue

Overview

AI-generated overview

Local MCP server for AWS IoT Core that lets an assistant manage devices, shadows, jobs, certificates, policies and rules in an AWS account.

What you can do
List, search, create, update and delete things, thing types and thing groups, including group membership and fleet-index queries (search needs indexing enabled). Read, update and delete classic or named device shadows, and list named shadows per thing. Publish MQTT messages to the device fleet through the IoT Data Plane. Create, list, cancel and delete fleet jobs and track per-device job executions. Manage device auth: generate key pairs and certificates, set certificate status, and create, attach and delete IoT policies. List, create, enable, disable and delete SQL-based topic rules, and look up the account's IoT data endpoint.
When to use it
Useful when an assistant should inspect or operate an AWS IoT Core fleet from a local session: auditing registered devices, reading or updating shadow state, pushing OTA or remote-command jobs, or reviewing message routing rules. It is scoped to IoT Core only, not Greengrass, SiteWise, Device Defender or TwinMaker.
Requirements
Runs locally as a Python package via uvx (stdio). Needs AWS credentials through the standard SDK chain: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY and optionally AWS_SESSION_TOKEN, or AWS_PROFILE, or an attached IAM role. AWS_REGION is required because IoT Core is regional; AWS_ENDPOINT_URL can override the endpoint. Network access to AWS is needed.
Before you install
It acts on a real AWS account with the permissions of the supplied credentials, so scope them narrowly. Many tools write or delete: create/update/delete of things, groups, shadows, jobs, certificates, policies and rules, plus publishing MQTT messages to devices. Deletions are irreversible and require confirm=True; create/put overwrite checks are best-effort, not race-free. create_keys_and_certificate returns the private key only once. Credentials are read from environment variables or profile.

Installation

In SourceWeft

  1. Open AWS IoT Core in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

AWS IoT Core MCP Server

A Model Context Protocol (MCP) server for AWS IoT Core — device registry, device shadows, jobs (fleet management), the rules engine, and messaging.

Scoped deliberately to IoT Core itself: no Greengrass (separate edge-deployment API), no IoT SiteWise (already has an official awslabs MCP server), no Device Defender/Events/TwinMaker — each of those is its own AWS service with its own API and would be its own connector.

Built with FastMCP and boto3.

Tools

Things (device registry)

ToolDescription
list_things(thing_type_name, attribute_name, attribute_value, thing_group_name, max_results)List things, optionally filtered.
search_things(query_string, index_name, max_results)Fleet-indexing search, e.g. attributes.location:"lab-1". Requires indexing to be enabled.
get_thing(thing_name)Fetch a thing's attributes and type.
create_thing(thing_name, thing_type_name, attributes, billing_group_name, overwrite=False)Register a new thing.
update_thing(thing_name, attributes, thing_type_name, remove_thing_type, attributes_merge=True)Update a thing's attributes/type.
delete_thing(thing_name, confirm=False)Delete a thing. Irreversible.

Thing Types & Thing Groups

ToolDescription
list_thing_types(thing_type_name) / get_thing_type(thing_type_name)List/read thing types.
create_thing_type(thing_type_name, description, searchable_attributes)Create a thing type. Immutable once created (AWS limitation) — only deprecation is supported after.
deprecate_thing_type(thing_type_name, undo=False)Deprecate (or un-deprecate) a thing type.
list_thing_groups(parent_group, name_prefix_filter) / get_thing_group(thing_group_name)List/read thing groups.
create_thing_group(thing_group_name, parent_group_name, attributes, overwrite=False)Create a thing group.
delete_thing_group(thing_group_name, confirm=False)Delete a thing group. Irreversible.
modify_thing_group_membership(thing_name, thing_group_name, action)action="add" or "remove" a thing from a group.
list_things_in_thing_group(thing_group_name)List members of a group.

Device Shadows (data plane)

ToolDescription
get_thing_shadow(thing_name, shadow_name)Read a thing's shadow document (desired/reported/delta). Omit shadow_name for the classic (unnamed) shadow.
update_thing_shadow(thing_name, desired, reported, shadow_name)Merge-update desired and/or reported state.
delete_thing_shadow(thing_name, shadow_name, confirm=False)Delete a shadow document.
list_named_shadows_for_thing(thing_name)List named (non-classic) shadows for a thing.

Messaging

ToolDescription
publish_message(topic, payload, qos=0)Publish an MQTT message to the device fleet via the IoT Data Plane.

Jobs (fleet management)

ToolDescription
list_jobs(status, thing_group_name, max_results) / get_job(job_id)List/read jobs.
create_job(job_id, thing_arns, document, description, target_selection="SNAPSHOT")Create a fleet job (e.g. an OTA update or remote command).
cancel_job(job_id, confirm=False, comment, force=False)Cancel a job.
delete_job(job_id, confirm=False, force=False)Delete a job. Irreversible.
list_job_executions_for_job(job_id, status) / list_job_executions_for_thing(thing_name, status)Track per-device execution status.

Certificates & Policies (device auth)

ToolDescription
create_keys_and_certificate(set_as_active=True)Generate a new key pair + certificate. The private key is returned only once — capture it immediately.
get_certificate(certificate_id) / list_certificates(page_size)Read certificate metadata.
set_certificate_status(certificate_id, status)ACTIVE, INACTIVE, or REVOKED.
delete_certificate(certificate_id, confirm=False, force_delete=False)Delete a certificate. Irreversible.
create_policy(policy_name, policy_document, overwrite=False) / get_policy / list_policiesManage IAM-style IoT policies (JSON documents).
delete_policy(policy_name, confirm=False)Delete a policy. Irreversible.
modify_policy_attachment(policy_name, target, action)Attach/detach a policy to/from a certificate ARN.
modify_thing_principal(thing_name, principal, action)Attach/detach a certificate (principal) to/from a thing.
list_thing_principals(thing_name) / list_principal_things(principal)Look up thing↔certificate associations either direction.

Rules Engine

ToolDescription
list_topic_rules(topic) / get_topic_rule(rule_name)List/read SQL-based message routing rules.
put_topic_rule(rule_name, sql, actions, description, sql_version, overwrite=False)Create or replace a rule. actions is a list of raw AWS action objects (e.g. {"lambda": {"functionArn": "..."}}).
set_topic_rule_enabled(rule_name, enabled)Enable/disable a rule without deleting it.
delete_topic_rule(rule_name, confirm=False)Delete a rule. Irreversible.

Misc

ToolDescription
get_endpoint(endpoint_type)Look up this account's IoT Core data endpoint (default iot:Data-ATS).

Safety conventions

Same as the rest of this repo: create_*/put_* default to overwrite=False (best-effort — the AWS IoT API itself has no conditional-write header for most of these operations, so this is a describe-then-create check, not fully race-free like Ditto's If-None-Match). Every delete_*/cancel_* requires confirm=True.

Configuration

Standard AWS SDK credential resolution — no custom env vars for auth. Set whichever of these your setup uses:

Env varDescription
AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY / AWS_SESSION_TOKENExplicit credentials.
AWS_PROFILENamed profile from ~/.aws/credentials.
AWS_REGION / AWS_DEFAULT_REGIONRequired — AWS IoT Core is regional.
AWS_ENDPOINT_URLOverride the API endpoint (e.g. for LocalStack). boto3 reads this natively.

Or an IAM role, if running somewhere with one attached (EC2/ECS/Lambda). See boto3's credential docs.

Running locally

bash
uv syncexport AWS_REGION=us-east-1# plus whichever credential env vars apply to youuv run awsiotcoremcpserver.py

See mcp.json for ready-to-use client configs (stdio and Docker).

Testing

This repo's design principles call for testing against a real instance rather than mocks. AWS IoT Core has no official local emulator, and LocalStack's IoT support requires a paid plan (no free tier) — so this server is the one exception in this repo: tests run against moto, a mature, free, open-source AWS API emulator (not hand-rolled mocks — it implements real request/response behavior for the actual boto3 calls this server makes).

bash
uv run pytest -v

License notes

No bundled deployment artifacts here (unlike the other servers) since there's no local broker/service to run — AWS IoT Core only exists as an AWS-hosted service.

Source: aws-iot-core/README.md at commit 5a985b6

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Core integrations