Skip to main content

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)

Source distribution for buildshield-mcp 0.1.1
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)

Table of built distributions (wheels) for buildshield-mcp 0.1.1
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page