FindMyBids connector: technical reference
FindMyBids finds open public bids (federal, state and local) for small businesses, updated every morning. The connector lets an AI assistant search bids, explain one, check whether the signed-in person's business is ready to bid, and walk them through registrations. 8 tools are read only; 2 save to the person's own account, only when they ask. No tool submits bids, fills in registrations, pays, sends email or deletes anything. Setting it up as a user: Use FindMyBids in your AI assistant.
Endpoints
| What | URL |
|---|---|
| MCP server (Streamable HTTP) | https://findmybids.com/mcp · account tools ask the person to sign in |
| MCP server, no sign-in | https://findmybids.com/mcp/public · the same server; never asks to sign in, so account tools answer with a sign-in message |
| Protected resource metadata | https://findmybids.com/.well-known/oauth-protected-resource |
| Authorization server metadata | https://findmybids.com/.well-known/oauth-authorization-server |
| Client registration | https://findmybids.com/oauth/register · Client ID Metadata Documents also accepted |
| Authorize · token · revoke | https://findmybids.com/oauth/authorize · https://findmybids.com/oauth/token · https://findmybids.com/oauth/revoke |
Sign-in and scopes
OAuth 2.1 authorization code flow with PKCE (S256) and dynamic client registration, so no client ID needs to be issued in advance. The person signs in with their FindMyBids account (free) by email link. Access tokens last 60 minutes. Refresh tokens last 90 days and rotate; reusing an old one revokes the whole grant. Tokens are stored only as SHA-256 hashes, and each one sees only its own person's account. Signing out everywhere on the website also signs out connected apps. All traffic is HTTPS.
| Scope | Allows |
|---|---|
bids | Search and read bids, the person's alert matches and business profile, readiness checks, and, when the person asks, saving their business profile (save_profile) and private bid invitations (add_private_bid). |
bids.read | Read only. save_profile and add_private_bid aren't listed and refuse if called. The person can also choose this on the sign-in screen by ticking Read only. |
offline_access | A refresh token, so the person doesn't sign in every hour. |
Public tools work without a token. Calling an account tool on /mcp without one answers HTTP 401 with a WWW-Authenticate header pointing at the resource metadata, so the app shows its Connect button. Each tool's securitySchemes says whether it needs sign-in.
Tools
| Tool | Type | Sign-in | What it does | Inputs | Side effects |
|---|---|---|---|---|---|
search_bidsSearch open bids |
Read | No | Search open bids (government contracts and RFPs) that FindMyBids tracks. query: keywords, e.g. "roof repair", "janitorial", "IT help desk". Commas mean OR: "roofing, gutters". states: two-letter codes where the work is, e.g. ["PA", "MD"]. level: "federal", "state", "local" or "private" (private = bids private companies posted on FindMyBids, plus invitations the signed-in user saved). naics: NAICS code prefixes, e.g. ["5617", "238"]. set_aside: text to match, e.g. "Small Business", "8(a)", "HUBZone", "WOSB", "SDVOSB". due_after: ISO date; defaults to today (only bids still open). | query (string, optional, default "")states (array, optional)level (string, optional)naics (array, optional)set_aside (string, optional)due_after (string, optional)limit (integer, optional, default 15) |
None. Read only. |
get_bidGet bid details |
Read | No | Details for one bid. bid_id: a FindMyBids bid ID, e.g. "nj:27DPP01349". include_text=true also reads the bid page and main document and returns an excerpt. | bid_id (string)include_text (boolean, optional, default false) |
Reads the official bid page and its documents only when include_text is true. Nothing is changed. |
get_my_bidsMy matching bids |
Read | Yes | Open bids that match the user's saved FindMyBids alerts (the same list as My bids on findmybids.com), soonest deadline first. new_since_days: only bids posted in the last N days (e.g. 1 for today's new bids). | new_since_days (integer, optional) |
None. Read only. |
check_readinessCheck if I'm ready to bid |
Read | Yes | Check whether the user's business (their FindMyBids business profile) is ready to bid. Give ONE of: bid_id (a FindMyBids bid ID), url (link to any bid page or PDF, any state or private client), or text (pasted bid text). For url/text, also pass state (two letters), level ("federal"/"state"/"local"/ "private") and due_date (ISO) if known. Returns a verdict, each requirement with status gap / check / ready / info, the sentence it came from, walkthrough links for registration gaps, and an excerpt of the bid to confirm against. Free accounts get 3 checks a month (shared with the website); Pro is unlimited. | bid_id (string, optional)url (string, optional)text (string, optional)state (string, optional)level (string, optional)due_date (string, optional)title (string, optional) |
Reads the bid's official page or the link given. Counts one readiness check toward the Free plan's monthly limit. Nothing in the user's account is changed. |
get_walkthroughRegistration guide |
Read | No | Step-by-step registration guide. portal: a state code or name ("PA", "Ohio"), "sam" for SAM.gov, or "us-sba-certifications" for SBA set-aside certifications. Also returns bid_forms: the standard affidavits, certifications, bonds and diversity forms bidders are commonly asked for there, with links to the official blank forms. | portal (string) |
None. Read only. |
list_walkthroughsList registration guides |
Read | No | All registration guides: SAM.gov, SBA certifications, and all 50 states. | none | None. Read only. |
get_profileMy business profile |
Read | Yes | The user's saved business profile used by check_readiness (same as findmybids.com/account/business), plus the template of fields it understands. | none | None. Read only. |
save_profileUpdate my business profile |
Write | Yes | Save or update the user's business profile (merged into what's saved). Fields: company_name, home_state, naics (list), certifications (list), registrations ({"SAM": {"status": "active", "expires": "YYYY-MM-DD"}, "PA": {"status": "active"}}), insurance (dollar limits), bonding, licenses, states_qualified. | profile (object) |
Merges the fields the user gave into their saved business profile (the same profile as findmybids.com/account/business), replacing those fields' old values. Other fields are kept. The user can change it back on the website. Nothing is sent, paid or deleted. |
add_private_bidSave a private bid invitation |
Write | Yes | Save a private bid invitation the user received (from a general contractor, property owner, or any company) so it shows up in their own searches alongside public bids. Only the user can see it. Paste the invite text or give its link. | title (string)text (string, optional)url (string, optional)agency (string, optional)due_date (string, optional)state (string, optional) |
Saves the invitation as a private bid only this user can see, so it shows in their searches and readiness checks. If a link is given, FindMyBids reads that page once to fill in the details. The user can remove it on the website. Nothing is sent, paid or deleted. |
sources_statusBid source status |
Read | No | When each bid source last updated and whether it worked. | none | None. Read only. |
Errors and limits
- An account tool without sign-in: HTTP 401 with
WWW-Authenticate, or an error result asking the person to sign in. - A bid id that doesn't exist or isn't the person's private bid:
No bid with id … - save_profile or add_private_bid on a read-only connection:
This connection is read only, so … wasn't saved. - Plan limits match the website: a Free account gets 3 readiness checks a month and its top 5 alert matches; Pro has no limits. Requests over 2 MB are refused.
- No payments, purchases, bid submissions or form filling anywhere in the connector.
Data
Public tools read public bid listings. Account tools see only the signed-in person's own alerts, business profile and private bids. The assistant's conversation isn't sent to FindMyBids, only each tool's inputs. What's kept, who processes it and for how long: privacy policy.
Contact
Support and security: support@findmybids.com (also in security.txt). App directory reviewers get a test account in the submission. FindMyBids is made by Murfle Interactive, LLC.