Credentials. The ingest key gives the connected agent access to your workspace, so use a key scoped for development and rotate it if it leaks.
Who it is forA developer who uses a coding agent day to day and wants it to inspect failing traces and set up cases without leaving the editor.
The problemSwitching between the editor and the Tracely UI slows down debugging of agent failures.
The outcomeA coding agent reads traces, creates evaluators, cases and alerts in your workspace through the MCP endpoint.
What you need first
- Docker and Docker Compose
- For local development: uv, Node 20+ and pnpm
- A GitHub repository with pull requests, if you want the CI gate
- Python, to install the tracelyai-sdk package
Steps
- Run
docker compose --profile demo up -d --build --waitto start a local Tracely instance. - Note the ingest key from the seeded project, which the README lists as
tracely_dev_keyfor local use. - Add the MCP endpoint at http://localhost:8000/mcp to your coding agent's MCP settings with that key.
- Ask the agent to list recent failing traces and summarize them.
- Review anything the agent creates in the Tracely UI before relying on it.
Prompt for your agent
Using the Tracely-ai repository running locally at http://localhost:8000, connect to the MCP endpoint at /mcp with the ingest key <ingest-key>. List the five most recent failing traces and report their agent names and failure reasons. Verify that the list matches what the traces view shows at http://localhost:3001.
Caveat. The README says the MCP endpoint uses an ordinary ingest key, but the exact client configuration for each coding agent is not in the README and must be set up by you.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Disclaimer
Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked "Seen in the wild", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email [email protected] and we will look at it promptly. Full disclaimer page