About billwatch
billwatch is a remote MCP server publishing machine-readable US listed prices for streaming and VPN plans. Agents can filter current deals and check a plan’s price history without sending bills or account details to BillWatch.
Key features
- 01Search deals by category, provider, or plan
- 02View price history for a plan
- 03Machine-readable plan and billing details
- 04Verified status and price check dates
Use cases
- 01Compare a current streaming plan with listed alternatives
- 02Check how a VPN plan’s listed price has changed
- 03Filter deals by provider or category
MCP support
Provides a stateless remote MCP server over streamable HTTP, with `search_deals` and `get_price_history` tools. The endpoint requires no sign-up or API key.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://getbillwatchdog.com/mcpclaude mcp add --transport http com-getbillwatchdog-billwatch https://getbillwatchdog.com/mcp{"mcpServers":{"com-getbillwatchdog-billwatch":{"type":"http","url":"https://getbillwatchdog.com/mcp"}}}Open in Cursor{"servers":{"com-getbillwatchdog-billwatch":{"type":"http","url":"https://getbillwatchdog.com/mcp"}}}Open in VS Code{"mcpServers":{"com-getbillwatchdog-billwatch":{"type":"http","url":"https://getbillwatchdog.com/mcp"}}}{"mcpServers":{"com-getbillwatchdog-billwatch":{"serverUrl":"https://getbillwatchdog.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
2| Parameter | Type | Required | Description |
|---|---|---|---|
| plan_id | string | No | Return only the plan with this exact id, e.g. 'hulu-live-tv-only'. |
| category | enum | No | Only return plans in this category.streaming | vpn |
| provider | string | No | Only return plans whose provider name contains this text (case-insensitive), e.g. 'NordVPN'. |
| max_monthly_usd | number | No | Only return plans whose listed monthly-equivalent price is at most this many USD. |
| include_unverified | boolean | No | Also include plans that are unverified or no longer sold. Default false. |
Details
From the project READMEBillWatch
BillWatch publishes US advertised base prices for streaming and VPN plans in machine-readable form, so AI agents can compare a person's current plans against listed alternatives and watch for price changes. The person's agent holds the person's bills; BillWatch never receives bills, transactions or account details.
- Website: https://getbillwatchdog.com
- Interactive demo: https://getbillwatchdog.com/demo
- API docs: https://getbillwatchdog.com/api
- Privacy: https://getbillwatchdog.com/privacy
- Disclosure: https://getbillwatchdog.com/disclosure
Use the data
MCP server (remote)
Endpoint: https://getbillwatchdog.com/mcp (streamable HTTP, stateless, no sign-up or key)
Tools:
search_deals— download current deals and filter by category, provider or plan. Unverified or discontinued plans are excluded unlessinclude_unverifiedis set.get_price_history— pricing changes over time for one plan.
JSON API
GET https://getbillwatchdog.com/v1/deals.json— all plansGET https://getbillwatchdog.com/v1/deals/streaming.jsonand/v1/deals/vpn.json— one categoryGET https://getbillwatchdog.com/v1/price-history/{plan-id}.json— pricing changes over time for a plan- Manifest:
https://getbillwatchdog.com/.well-known/agent.json - Machine-readable index:
https://getbillwatchdog.com/llms.txt
The v1/ folder in this repository mirrors the current data snapshot. The live site is the source of truth.
Reading the data
Each record carries a stable id, provider, plan, listed monthly-equivalent USD price, billing terms, promo (the provider's own wording), url (the provider's sign-up page), source_url (the page the price was confirmed on), an affiliate flag, the checked_at date and a verified flag.
verified: true means the price was confirmed on the provider's official page within its freshness window; false means it is stale, discontinued or not yet confirmed there. Prices are listed prices, before taxes and extra fees; what a person pays can differ. Plans are listed by listed price. BillWatch makes no recommendations, and payment never affects which plans appear or their order.
Pilot notice
Free to use. These are direct provider links. BillWatch receives no affiliate commission from them. Every record has affiliate: false.
Ground rules for agents
- Never present a switch without the human's explicit approval. Present the option, the difference in listed price, and the workings.
- BillWatch never pays bills, moves money, cancels subscriptions, or contacts providers.
- Nothing here is financial advice. Surface facts; let the human decide.
Operated by Adam Bull, a sole trader in New South Wales, Australia. Contact: [email protected]
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.