- Home
- Skills
- APIs & Backend
- TopicForge
TopicForge
Read-only ROS 2 graph inspection, DDS diagnostics, and bag file analysis via MCP.
Free
Works with the AI Agents you already use
About this skill
Debugging a ROS 2 system often feels like shouting into a void when topics go silent or nodes fail to communicate. TopicForge provides a read-only inspection layer for live ROS 2 graphs, DDS buses, and recorded bags without the risk of accidentally commanding the robot.
What it does
- Live Graph Inspection lists topics, types, and counts while identifying node duplicates and blocked executors.
- Message Sampling captures live data with configurable timeouts and array truncation to handle high-bandwidth sensors.
- Deep Node Analysis retrieves service, action, and parameter listings, including specific QoS profiles for reliability and durability.
- Bag File Analysis extracts duration, frequency statistics, and per-topic counts from MCAP, SQLite3, and ROS 1 files.
- DDS Bus Diagnostics identifies endpoints and connectivity issues even when the standard ROS 2 CLI backend is unavailable.
How it works
- Health Check runs to determine if the agent is connected to a live robot, a mock environment, or a raw DDS bus.
- Discovery uses
list_topicsandlist_nodesto map the active communication graph and identify stakeholders. - Deep Dive invokes
get_topic_infoorget_node_infoto pinpoint QoS mismatches or unresponsive parameters. - Data Validation employs
sample_messagesorpeek_bag_samplesto verify the actual content flowing through the pipes.
Frameworks & tools
Built for ROS 2 (Humble, Iron, Jazzy) using the TopicForge MCP server. Supports MCAP, db3, and legacy .bag formats via the rosbags library. Compatible with CycloneDDS and other RMW implementations.
Why this beats prompting it yourself
Standard LLMs cannot see your local robot's middleware or parse binary bag files. This skill provides the specific tools to bridge the gap between the agent and the live ROS 2 computational graph with built-in safety constraints.
Use cases
- Diagnose why two nodes are failing to communicate due to QoS durability mismatches.
- Audit a recorded MCAP bag file to find missing frames or unexpected message drops.
- Inspect live sensor data like LaserScan or Image streams without crashing the agent with large arrays.
- Identify blocked node executors by detecting timeouts during parameter retrieval.
Known limitations
Read-only by design; cannot publish messages or call services. Requires the TopicForge MCP server and a local ROS 2 installation for live graph access.
Read-only access only. Requires local ROS 2 installation or TopicForge MCP server setup. Large message types like PointCloud2 require explicit array length configuration to avoid truncation.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
1 use
Times used to date
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 26 days ago
- Free with an Agensi account
Requires