buildshield-mcp
MCP server for BuildShield — AI cost intelligence for agents.
Install
pip install buildshield-mcp
Configure (Claude Desktop / Cursor)
Add to your MCP config (~/.config/claude/claude_desktop_config.json):
{
"mcpServers": {
"buildshield": {
"command": "buildshield-mcp",
"env": {
"BUILDSHIELD_API_KEY": "bsk_..."
}
}
}
}
Get your API key at thebuildshield.com/settings.
buildshield-mcp is the MCP server command. Keep it inside your MCP client
configuration; it waits on stdio and is not meant to print a normal help screen.
Terminal smoke tests
The package also installs CLI wrappers for the same tool handlers:
buildshield_check_cost gpt-4.1 50000 10000
buildshield_get_pricing claude-sonnet-4.6
buildshield_recommend_model "code review" --min-context-tokens 200000
You can also use the grouped command form:
buildshield check-cost gpt-4.1 50000 10000
Tools
| Tool | Description | Requires key? |
|---|---|---|
buildshield_check_cost |
Exact cost for model + token count | No — offline |
buildshield_recommend_model |
Best models for a task with filters | No — offline |
buildshield_get_pricing |
Browse all model pricing | No — offline |
buildshield_optimize_prompt |
Rule-based prompt compression (20-40% savings) | No — offline |
buildshield_check_budget |
Check remaining budget for your API key | Yes |
buildshield_log_usage |
Log usage to your dashboard | Optional |
Examples
"What does claude-sonnet-4.6 cost for 50K input + 10K output tokens?"
→ buildshield_check_cost(model="claude-sonnet-4.6", input_tokens=50000, output_tokens=10000)
"What's the cheapest model with at least 200K context?"
→ buildshield_recommend_model(task="long document analysis", min_context_tokens=200000)
"Compress this system prompt"
→ buildshield_optimize_prompt(text="...", aggressiveness="medium")
Metadata
Release files for buildshield-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| buildshield_mcp-0.1.1.tar.gz | 11.5 kB | Without provenance | Details for buildshield_mcp-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| buildshield_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for buildshield_mcp-0.1.1-py3-none-any.whl |
Total release size: 24.7 kB
Release files / buildshield_mcp-0.1.1.tar.gz
| Download URL | buildshield_mcp-0.1.1.tar.gz |
|---|---|
| Size | 11.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cfad779c45628670c7088473a30461d64936b4b2c695c021835972849212a53e
|
|
BLAKE2b-256 checksum How to use checksums |
1250a4ba3a331a44bf499200d017e6a7b59f199815f0913c128fc0bcff9be889
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.4
|
Release files / buildshield_mcp-0.1.1-py3-none-any.whl
| Download URL | buildshield_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 13.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
83fbab0234ff331a11a65b9c4cae7ed8301b9efc5a7907fa226ed0952e74c182
|
|
BLAKE2b-256 checksum How to use checksums |
65f2981f9e21a48cac971f483c049533af2c73119ab69e413c89b526828f6f4c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.4
|
Security for buildshield-mcp 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.