Skip to main content
Glama
Sign In
pushbuild-mcp

pushbuild-mcp

Official
by pushbuild
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

pushbuild-mcp

A local (stdio) MCP server for the Pushbuild data APIs: 400+ official public-data sources, each returning clean JSON records with a stated source. Coverage includes US election results and campaign finance, lobbying, court cases, restaurant inspections, building permits, business registries, SEC filings and 13F holdings, recalls, sanctions lists, central bank and economic statistics, and weather.

It runs on your machine and needs nothing beyond Python 3.9+. Search runs locally over the public catalog (https://api.pushbuild.com/llms.txt), describe reads each API's OpenAPI spec, and call_api runs the API through the Pushbuild REST API with your key.

Tools

  • search_apis: find an API by keyword.

  • describe_api: inputs and coverage of one API.

  • call_api: run an API and get records. Needs a key.

All three only read data.

Related MCP server: @cyanheads/openfec-mcp-server

Install

pip install "git+https://github.com/pushbuild/pushbuild-mcp"

Get a free key (monthly free usage, no card): https://pushbuild.com/apis/app/signup

Claude Desktop / Cursor / any MCP client

{
  "mcpServers": {
    "pushbuild": {
      "command": "pushbuild-mcp",
      "env": { "PUSHBUILD_API_KEY": "YOUR_KEY" }
    }
  }
}

Without installing: "command": "uvx", "args": ["--from", "git+https://github.com/pushbuild/pushbuild-mcp", "pushbuild-mcp"].

Clients that support remote servers can instead connect to https://api.pushbuild.com/mcp directly (OAuth sign-in). Docs: https://pushbuild.com/apis/mcp.html

License

MIT

Available Tools

3 tools
call_apiRun an APIA
Read-only

Run one API with parameters from describe_api and return JSON records (default 20; set maxItems up to 500). Needs PUSHBUILD_API_KEY (free key with monthly free usage: https://pushbuild.com/apis/app/signup).

Inputs: api (required), params (required).

describe_apiDescribe an APIB
Read-only

Input parameters (JSON Schema) and coverage of one API id from search_apis. No key needed.

Inputs: api (required).

search_apisSearch APIsA
Read-only

Find Pushbuild data APIs by keyword (e.g. 'campaign contributions texas', 'restaurant inspections', 'sec 13f'). Returns API ids and what each covers. No key needed.

Inputs: query (required), limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.7/5.0

    Scored across 3 tools

    Disambiguation5/5

    The three tools form a clean, non-overlapping pipeline: search_apis discovers API ids, describe_api explains one id's schema, and call_api executes it. Each has a distinct input (keyword vs. api id vs. api id + params) and output, so an agent cannot easily misselect.

    Naming Consistency5/5

    All three follow an identical verb_noun snake_case pattern (search_apis, describe_api, call_api). The shared '_api(s)' noun makes the workflow progression explicit.

    Tool Count4/5

    Three tools is lean but each earns its place; the discover-describe-call triad is the minimal complete surface for an API gateway. It sits at the low end of the comfortable range, with no redundant entries.

    Completeness4/5

    The core lifecycle (find → understand → invoke) is fully covered, including auth notes and maxItems control. Minor gaps exist: no pagination/cursor for large result sets beyond maxItems=500, no way to browse all APIs without a keyword, and no key-validation or error-inspection helper.

    Resources

    Related MCP Connectors

    Related MCP Servers

    • fec-mcp

      bsilha
      F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that searches official FEC PDF rulebooks for compliance and contribution limits, and provides real-time lookups against the OpenFEC API for candidates, committees, filings, and financial data.
      -