Docs

MCP (recommended)

Endpoint: https://dowser-sooty.vercel.app/mcp
Transport: Streamable HTTP, stateless, JSON responses. Send Accept: application/json, text/event-stream as the MCP SDKs do.
No authentication is required. Requests are rate-limited per client.

Meta Muse

Muse can add Dowser as a custom connector in one message:

Build a custom integration to Dowser. Its MCP server URL is https://dowser-sooty.vercel.app/mcp (streamable HTTP, no authentication). I want you to be able to find class action settlements, product recalls, unused credit card credits, expiring points and birthday freebies I qualify for, from any future conversation. Connect to it, test every tool end to end, show me the results, and save the integration as a reusable skill.

Claude, Cursor, other MCP clients

{ "mcpServers": { "dowser": { "url": "https://dowser-sooty.vercel.app/mcp" } } }

REST

Each tool is also a GET endpoint under https://dowser-sooty.vercel.app/api/v1/. Arrays are comma-separated. Machine-readable description: /openapi.json.

curl "https://dowser-sooty.vercel.app/api/v1/settlements?brands=Apple,Ticketmaster&state=CA&limit=5"
curl "https://dowser-sooty.vercel.app/api/v1/recalls?products=Peloton%20Tread,Cosori%20air%20fryer"
curl "https://dowser-sooty.vercel.app/api/v1/cards?cards=Amex%20Platinum,Sapphire%20Reserve"
curl "https://dowser-sooty.vercel.app/api/v1/freebies?state=TX&birthday=03-14"

search_settlements · GET /api/v1/settlements

Find open U.S. class action settlements the person may be able to claim, matched against brands, companies and products they have used. Returns eligibility summary, payout, claim deadline, days left, whether proof or a notice ID is needed, and the official claim link. Use it when someone asks about class actions, settlements, or "money I might be owed", and feed it the brands found in their receipts, subscriptions and bank transactions. Read-only.

Example prompts:

• Search for class action settlements I might be eligible for based on the companies in my email receipts, and tell me which ones are worth filing.
• Which open settlements need no proof of purchase and close in the next 30 days?
• Is there a settlement involving my bank or my phone carrier?

match_recalls · GET /api/v1/recalls

Check products the person owns against U.S. Consumer Product Safety Commission recalls from the last three years, with the remedy (refund, replacement or repair), where it was sold, and how to contact the company. Use it when someone lists things they bought, especially baby gear, appliances, furniture, fitness equipment and toys. Read-only; queries the live CPSC API for anything newer than the bundled snapshot.

Example prompts:

• Go through my Amazon and Target order emails from the last two years and check whether anything I bought has been recalled.
• Has my Peloton treadmill or my Cosori air fryer been recalled? What do I get?

card_benefits · GET /api/v1/cards

List the recurring statement credits, memberships and activation-required perks on the person's credit cards, with when each current period ends and how to use it. Pair it with their transactions to spot credits they have not used this month, quarter or year. Use it for "am I leaving card benefits on the table", "what credits reset soon", or before an annual fee posts. Read-only, hand-maintained catalogue of popular U.S. cards.

Example prompts:

• Check my credit cards for statement credits, perks or points expiring soon that I have not used, and tell me how to capture them.
• Which of my card credits reset at the end of this month?

points_expiry · GET /api/v1/points

Explain when miles and points expire for airline, hotel, bank and retail loyalty programs, and, given the date of last activity, compute the expiry date and days left plus the cheapest ways to keep them alive. Use it when someone mentions a frequent flyer or hotel program, or asks whether their points are about to expire. Read-only.

Example prompts:

• Are any of my airline miles or hotel points about to expire? My last American flight was in 2024.
• How do I keep my Marriott points from expiring without a stay?

birthday_freebies · GET /api/v1/freebies

List U.S. chains that give loyalty members something free or discounted for their birthday, with the reward, the program to join, how it is delivered, whether a purchase is needed and the latest date to sign up. Filter by state and category. Use it for "free stuff on my birthday" and to set sign-up reminders a few weeks ahead. Read-only.

Example prompts:

• Find all the places near me where I can get something free on my birthday, and sign me up for the ones I approve.
• My birthday is March 14. What do I need to join before then, and by when?

check_for_new · GET /api/v1/updates

One call for a recurring sweep: new settlements matching the person's brands, new recalls matching their products, and card credits whose period ends soon. Pass the date of the last check as "since". Ideal for a weekly or monthly background task that reports only when something actionable appears. Read-only.

Example prompts:

• Every Monday, check whether any new settlements or recalls apply to me and remind me about card credits that reset this month. Only message me if there is something to do.

• Settlements: OpenClassActions.com and ClassAction.org open-settlement directories, merged and de-duplicated, refreshed daily. Both are independent directories, not settlement administrators or law firms. Expired deadlines are filtered at query time.
• Recalls: the U.S. Consumer Product Safety Commission public recalls API. A three-year snapshot is bundled and refreshed daily; each request also tops up from the live API for anything newer.
• Card benefits, points expiry, birthday rewards: hand-maintained catalogues with a last_reviewed date, a confidence rating and a verification URL on every entry. Corrections are welcome through the support page.

• U.S. only. Settlements, recalls and rewards are U.S. programs.
• Rate limit: 60 requests per minute per client. Responses include Retry-After when exceeded.
• All tools are annotated readOnlyHint: true. Nothing is written, purchased, filed or sent.
• Results carry a disclaimer and a sources list. Assistants should show the official link and ask before acting.