FindMyBids

Find government bids you can actually win. FindMyBids checks federal, state and local bids every morning, emails you the ones that fit your business, and shows what you need to bid. Free to start.

Get my free alert
For developers and app directory reviewers

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

WhatURL
MCP server (Streamable HTTP)https://findmybids.com/mcp · account tools ask the person to sign in
MCP server, no sign-inhttps://findmybids.com/mcp/public · the same server; never asks to sign in, so account tools answer with a sign-in message
Protected resource metadatahttps://findmybids.com/.well-known/oauth-protected-resource
Authorization server metadatahttps://findmybids.com/.well-known/oauth-authorization-server
Client registrationhttps://findmybids.com/oauth/register · Client ID Metadata Documents also accepted
Authorize · token · revokehttps://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.

ScopeAllows
bidsSearch 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.readRead 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_accessA 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

ToolTypeSign-inWhat it doesInputsSide effects
search_bids
Search 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_bid
Get 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_bids
My 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_readiness
Check 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_walkthrough
Registration 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_walkthroughs
List registration guides
Read No All registration guides: SAM.gov, SBA certifications, and all 50 states. none None. Read only.
get_profile
My 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_profile
Update 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_bid
Save 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_status
Bid 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.