Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@blacksmith-mcpShow me the failed tests from the latest workflow run"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
blacksmith-mcp
An MCP (Model Context Protocol) server for Blacksmith CI analytics.
Query your CI/CD data directly from Claude - workflow runs, jobs, test results, usage metrics, and more.
Installation
Configuration
1. Get Your Session Cookie
Blacksmith uses session-based authentication. You'll need to extract your session cookie from your browser:
Log in to app.blacksmith.sh
Open Chrome DevTools (F12)
Go to Application > Cookies >
https://app.blacksmith.shFind the cookie named
sessionCopy its value
2. Set Environment Variables
3. Add to Claude Code
Or add to your project's .mcp.json:
Available Tools
Tool | Description |
| List all accessible Blacksmith organizations |
| Get org status (personal, onboarded, runner region) |
| List recent workflow runs with optional date filtering |
| Get details of a specific workflow run |
| Get job details including steps and runner info |
| Get raw log output for a job |
| Get test results for a job (with status filtering) |
| Get only failed tests with error messages |
| Get current core usage snapshot |
| Get current billing period amount |
Example Usage
Once configured, you can ask Claude things like:
"Show me the last 10 workflow runs"
"Get the failed tests from run 12345678"
"What's our current Blacksmith usage?"
"Show me the logs for job 98765432"
Development
Session Cookie Expiration
If you see a SESSION_EXPIRED error, your cookie has expired. Extract a new one from your browser and update BLACKSMITH_SESSION_COOKIE.
API Notes
This server uses Blacksmith's internal web API, which is undocumented and may change. The API was reverse-engineered from the Blacksmith web app.
License
MIT - see LICENSE
Contributing
Contributions welcome! Please see CONTRIBUTING.md for guidelines.