blacksmith-usage-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BLACKSMITH_ORG | No | Your GitHub org slug for Blacksmith.sh usage. Optional; can be passed as argument to tools. | |
| BLACKSMITH_SESSION_FILE | No | Path to a file containing the session JSON. Defaults to ${XDG_CONFIG_HOME:-~/.config}/blacksmith-usage-mcp/session.json. | |
| BLACKSMITH_SESSION_JSON | No | Full session JSON inline. Handy for CI/headless, where you inject a cookie harvested elsewhere. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| blacksmith_whoamiA | Who the stored Blacksmith session belongs to (verifies auth is live). |
| blacksmith_list_orgsA | List GitHub orgs/installations available to the session. |
| blacksmith_cost_summaryB | Headline cost for a month: total jobs, billable minutes, and dollar cost. |
| blacksmith_cost_dailyB | Per-day breakdown of jobs, minutes, and cost for a month. |
| blacksmith_cost_by_repoC | Cost broken down by repository for a month. |
| blacksmith_cost_by_runnerA | Cost broken down by runner type (e.g. blacksmith-4vcpu-ubuntu-2404) for a month. |
| blacksmith_sticky_disk_costB | Sticky-disk (Docker cache) storage cost and GB-hours for a month. Often the largest line item. |
| blacksmith_monthly_usageB | Billable vs included-free minutes for a month (free-tier headroom). |
| blacksmith_current_vcpuA | Live vCPU/job usage right now, by architecture (null when idle). |
| blacksmith_vcpu_timeseriesC | vCPU/job usage time series for a month (windowed). Large payload. |
| blacksmith_cost_overviewA | One-shot cost report for a month: totals, free-tier headroom, sticky-disk, and the top repos + runner types by cost. |
| blacksmith_sticky_disk_dailyA | Daily sticky-disk / Docker-layer-cache footprint (GB held each day) for a month — the cache growth curve. Steadily-climbing totals mean an unbounded cache (set max-cache-size-mb on setup-docker-builder); a flat line means a stable working set. |
| blacksmith_cost_trendA | Month-over-month compute vs sticky-disk cost for the last N months — spots accumulating cache cost vs one-off compute spikes. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/dholliday3/blacksmith-usage-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server