mastra-api

Interact with the Mastra development server API to debug agents and inspect threads.

2|2|Updated Nov 19, 2025
One-click install
npx skills add https://github.com/liatrio-labs/ai-prompts --skill mastra-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mastra-api
Source: https://github.com/liatrio-labs/ai-prompts/tree/main/skills/mastra-api
Command: npx skills add https://github.com/liatrio-labs/ai-prompts --skill mastra-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers debug issues with Mastra agents and interact with the Mastra development server API, streamlining the process of identifying and resolving errors in agent behavior and API interactions.

Core Features & Use Cases

  • Agent Debugging: Quickly retrieve conversation threads and identify errors within agent execution.
  • API Interaction: List and inspect available tools, workflows, agents, and observability data.
  • Use Case: When a Mastra agent fails unexpectedly, use this Skill to fetch the latest conversation thread, examine error messages, and inspect the available tools or workflows to pinpoint the cause of the failure.

Quick Start

Use the mastra-api skill to debug the latest conversation for the agent named 'my-agent'.

Frequently Asked Questions about mastra-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a Mastra agent that fails unexpectedly?

To debug a Mastra agent that fails unexpectedly, use a command-line interface to fetch the latest conversation thread, examine error messages, and inspect available tools or workflows to pinpoint the failure cause.

How can I inspect conversation threads and observability data for local agents?

You can inspect conversation threads and observability data by interacting with the Mastra development server API operating on localhost to retrieve runtime state and diagnose errors.

Does this API debugging approach require connecting to a remote Mastra server?

No, the API debugging approach facilitates runtime state inspection and error diagnosis specifically for Mastra agents operating locally on localhost, rather than requiring a remote server connection.

What is the best way to list and query available tools and workflows in a Mastra application?

The best way to list and query available tools and workflows is by using a command-line interface to interact directly with the Mastra development server API for inspection.

Why does my Mastra agent execution return errors I cannot trace?

Agent execution errors can be traced by retrieving conversation threads through the Mastra API to examine error messages and inspect available tools to pinpoint the cause of the failure.