`open_payments_search`

Pack: cms-open-payments · Endpoint: https://gateway.pipeworx.io/cms-open-payments/mcp

Search one CMS Open Payments program-year dataset using structured recipient, company, product, geography, payment-nature, and amount filters. CMS publishes company-reported relationships; a payment does not imply wrongdoing or a conflict.

Parameters

Name	Type	Required	Description
`year`	number	no	Program year (2019-current published year; default latest).
`payment_type`	string	no	Default General.
`recipient_npi`	string	no	Exact 10-digit NPI.
`recipient_last_name`	string	no	Exact recipient last name. CMS stores names uppercase; case is normalized for you. Pair with recipient_first_name — a common surname alone matches many practitioners.
`recipient_first_name`	string	no	Exact recipient first name, to disambiguate a common surname (e.g. last_name “PATEL” + first_name “RIPAL”).
`company`	string	no	Case-insensitive company-name substring.
`product`	string	no	Case-insensitive associated-product substring across all five product fields.
`state`	string	no	Exact two-letter recipient state.
`nature`	string	no	Exact nature of payment.
`minimum_amount`	number	no	Minimum reported payment in USD.
`limit`	number	no	Results (1-100, default 25).
`offset`	number	no	Pagination offset (0-10000).

Example call

Arguments

{
  "year": 2025,
  "recipient_last_name": "Smith",
  "state": "CA",
  "minimum_amount": 1000,
  "limit": 25
}

curl

curl -X POST https://gateway.pipeworx.io/cms-open-payments/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"open_payments_search","arguments":{"year":2025,"recipient_last_name":"Smith","state":"CA","minimum_amount":1000,"limit":25}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('open_payments_search', {
  "year": 2025,
  "recipient_last_name": "Smith",
  "state": "CA",
  "minimum_amount": 1000,
  "limit": 25
});

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "cms-open-payments": {
      "url": "https://gateway.pipeworx.io/cms-open-payments/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

open_payments_search