batch_search_grantsplus

DEPRECATED ALIAS — prefer search_grantsplus with a queries[] array, which now runs the identical batch fan-out. Kept for backward compatibility; behavior is unchanged. Search grants, prizes, and foundations comprehensively. Returns 10 results by default (~4KB). Use detail_level and max_results to control response size. Response includes total available count so you can request more if needed. Counts toward your monthly searches. A batch counts as 1 call.

read-only

Argument	Type	Description
since	string	Stateless alternative to posted_within_days/new_within_days: ISO 8601 instant. Only opportunities ingested at/after this instant.
offset	number	Number of results to skip for pagination (default: 0). Use with max_results to page through large result sets. Example: offset=100 with max_results=100 returns results 101-200.
source	string	Filter every batch sub-query to a specific source/domain, e.g. "grants.gov" or "deq.nc.gov".
queries*	array	Array of 2-5 search queries to run in parallel. Example for clean energy: ["renewable energy grants", "solar wind funding", "clean energy nonprofit", "sustainability grants", "green technology funding"]
max_results	number	Maximum opportunities to return (default: 10, max: 100). Token cost guide: 10 results ~4KB, 25 results ~10KB, 50 results ~20KB, 100 results ~40KB.
detail_level	string	Controls response verbosity. minimal (~120 bytes/result): id, title, org, deadline, url, qualityScore - best for scanning 50+ results. compact (~400 bytes/result, DEFAULT): adds snippet, category, status, deadlineType, daysUntilDeadline, deadlineLabel, and lastRoundClosedAt - good for recommendations. full (~1.5KB/result): everything including eligibility, amounts - only use with max_results <= 10.
user_context	object
grants_filters	object	Grants.gov specific filters
new_within_days	number	Backwards-compatible alias for posted_within_days. Only opportunities ingested (added by us) in the last N days -- for recurring/delta checks ("what is new since my last check"). Applied per sub-query before dedupe; response includes deduped newSince.newCount and the newest/oldest ingest timestamp in the window.
posted_within_days	number	Preferred alias for new_within_days: only opportunities ingested (added by us) in the last N days. Applied per sub-query before dedupe; the response includes a deduped newSince summary. If both posted_within_days and new_within_days are supplied, posted_within_days wins.
include_foundations	boolean	Also search private foundations (default: true)
max_response_tokens	number	Token budget for response (default: 4000 ≈ 16KB). Server auto-caps results to fit. Increase to 8000-16000 for more results per call, decrease to 2000 for lightweight scanning.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "queries"
  ],
  "properties": {
    "since": {
      "type": "string",
      "description": "Stateless alternative to posted_within_days/new_within_days: ISO 8601 instant. Only opportunities ingested at/after this instant."
    },
    "offset": {
      "type": "number",
      "default": 0,
      "minimum": 0,
      "description": "Number of results to skip for pagination (default: 0). Use with max_results to page through large result sets. Example: offset=100 with max_results=100 returns results 101-200."
    },
    "source": {
      "type": "string",
      "description": "Filter every batch sub-query to a specific source/domain, e.g. \"grants.gov\" or \"deq.nc.gov\"."
    },
    "queries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 5,
      "minItems": 1,
      "description": "Array of 2-5 search queries to run in parallel. Example for clean energy: [\"renewable energy grants\", \"solar wind funding\", \"clean energy nonprofit\", \"sustainability grants\", \"green technology funding\"]"
    },
    "max_results": {
      "type": "number",
      "default": 10,
      "minimum": 1,
      "description": "Maximum opportunities to return (default: 10, max: 100). Token cost guide: 10 results ~4KB, 25 results ~10KB, 50 results ~20KB, 100 results ~40KB."
    },
    "detail_level": {
      "enum": [
        "minimal",
        "compact",
        "full"
      ],
      "type": "string",
      "default": "compact",
      "description": "Controls response verbosity. minimal (~120 bytes/result): id, title, org, deadline, url, qualityScore - best for scanning 50+ results. compact (~400 bytes/result, DEFAULT): adds snippet, category, status, deadlineType, daysUntilDeadline, deadlineLabel, and lastRoundClosedAt - good for recommendations. full (~1.5KB/result): everything including eligibility, amounts - only use with max_results <= 10."
    },
    "user_context": {
      "type": "object",
      "properties": {
        "location": {
          "type": "string",
          "description": "State code or \"nationwide\""
        },
        "organization_type": {
          "enum": [
            "nonprofit",
            "startup",
            "small_business",
            "university",
            "government",
            "individual"
          ],
          "type": "string",
          "description": "Common natural-language phrasing (e.g. \"501(c)(3) nonprofit\") is also parsed; unparseable values are ignored with an explicit note in the response."
        }
      }
    },
    "grants_filters": {
      "type": "object",
      "properties": {
        "cfda": {
          "type": "string",
          "description": "CFDA number (e.g., \"10.001\")"
        },
        "agency_code": {
          "type": "string",
          "description": "Grants.gov agency code"
        }
      },
      "description": "Grants.gov specific filters"
    },
    "new_within_days": {
      "type": "number",
      "description": "Backwards-compatible alias for posted_within_days. Only opportunities ingested (added by us) in the last N days -- for recurring/delta checks (\"what is new since my last check\"). Applied per sub-query before dedupe; response includes deduped newSince.newCount and the newest/oldest ingest timestamp in the window."
    },
    "posted_within_days": {
      "type": "number",
      "description": "Preferred alias for new_within_days: only opportunities ingested (added by us) in the last N days. Applied per sub-query before dedupe; the response includes a deduped newSince summary. If both posted_within_days and new_within_days are supplied, posted_within_days wins."
    },
    "include_foundations": {
      "type": "boolean",
      "description": "Also search private foundations (default: true)"
    },
    "max_response_tokens": {
      "type": "number",
      "default": 4000,
      "minimum": 500,
      "description": "Token budget for response (default: 4000 ≈ 16KB). Server auto-caps results to fit. Increase to 8000-16000 for more results per call, decrease to 2000 for lightweight scanning."
    }
  }
}

batch_search_procurement

DEPRECATED ALIAS — prefer search_procurement with a queries[] array, which now runs the identical batch fan-out. Kept for backward compatibility; behavior is unchanged. Search federal contracts (SAM.gov) comprehensively. Returns 10 results by default (~4KB). Use detail_level and max_results to control response size. Response includes total available count so you can request more if needed. When sam_filters.pop_state (alias: place_of_performance_state) is set, the response includes a placeOfPerformance field summed across every sub-query (matched, unknownServed with unknowns excluded instead when user_context.location_strict is true, and otherStateExcluded). Counts toward your monthly searches. A batch counts as 1 call.

read-only

Argument	Type	Description
since	string	Stateless alternative to posted_within_days/new_within_days: ISO 8601 instant. Only opportunities ingested at/after this instant.
offset	number	Number of results to skip for pagination (default: 0). Use with max_results to page through large result sets. Example: offset=100 with max_results=100 returns results 101-200.
source	string	Filter every batch sub-query to a specific source/domain, e.g. "sam.gov".
queries*	array	Array of 2-5 search queries to run in parallel. Example for IT services: ["IT services contract", "software development federal", "technology consulting government", "computer services procurement"]
max_results	number

check_connection

Verify MCP server connectivity. Returns success immediately with no database calls. Use this FIRST if experiencing tool errors - a successful response confirms the server is reachable. It does not confirm account, search, or paid-feature authentication, which can still return "Auth required" separately. Does not count toward your monthly searches.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

deadline_calendar

Get upcoming funding deadlines for planning an application schedule. Default compact mode returns a merged `results` list of lean rows (id/title/org/deadline/daysUntil and direct url when it fits) plus section counts/index ranges so grants and procurement stay balanced without duplicating every row. Pass compact:false for full descriptions, quality details, and full `sections.grants` / `sections.procurement` arrays. Returns a bounded page of up to 50 candidate rows per section before calendar exclusions, not a complete calendar for the requested window. `coverage` preserves per-section candidate counts and executable candidate-search continuations; counts are not exact eligible totals. Non-biddable notices (Sources Sought, Award notices, etc.) and past/undated rows are excluded. Pass `category` to restrict to one type (e.g. "procurement" for contracts only). Available to authenticated free and paid accounts, within their search allowance. Free-plan listing-access limits still apply. Counts toward your monthly searches.

read-only

Argument	Type	Description
days	number	Alternative to weeks: exact number of days ahead to show (default: 28, max: 365)
weeks	number	Number of weeks ahead to show (default: 4, max: 12)
compact	boolean	Return compact rows by default to keep agent payloads small. Long titles/orgs/links may be shortened or omitted; set false for full descriptions, nested quality details, and full section arrays.
category	string	Optional. Restrict to ONE category instead of the default balanced grants+procurement view (e.g. "grant", "procurement", "prize"). Omit to get both grants and procurement as separate sections.

delete_saved_search

Delete a saved search by ID. Use list_saved_searches first to find the ID. Does not count toward your monthly searches.

destructive

Argument	Type	Description
id*	number	Saved search ID (from list_saved_searches)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "number",
      "description": "Saved search ID (from list_saved_searches)"
    }
  }
}

find_funders_of

Find the private foundations whose covered 990-PF filings name a given organization as a grant recipient. Use this to research who funds peer organizations doing work like the user's. Returns matched recipients with a confidence tier (registry_corroborated = an EIN matched a registry record; name_match = normalized organization name only), then that recipient's funders ranked by total recorded giving with amounts, grant-record counts, and the covered filing years. Historical filing evidence, NOT an open call, a current interest statement, or an eligibility signal. Does not count toward your monthly searches.

read-only

Argument	Type	Description
page	number	1-based page of matched recipients.
limit	number	Recipients per page (default 20, max 50).
state	string	Optional 2-letter state code to restrict matches to recipients recorded in that state.
organization*	string	Recipient organization name, at least 3 characters. Recipient names are written however the filing foundation chose to write them, so the shortest distinctive part of the name matches best.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "organization"
  ],
  "properties": {
    "page": {
      "type": "number",
      "description": "1-based page of matched recipients."
    },
    "limit": {
      "type": "number",
      "description": "Recipients per page (default 20, max 50)."
    },
    "state": {
      "type": "string",
      "description": "Optional 2-letter state code to restrict matches to recipients recorded in that state."
    },
    "organization": {
      "type": "string",
      "description": "Recipient organization name, at least 3 characters. Recipient names are written however the filing foundation chose to write them, so the shortest distinctive part of the name matches best."
    }
  }
}

find_similar

Find opportunities similar to a given one using semantic similarity. Returns each result with similarityScore (0-1) and a concise matchExplanation of shared signals such as category/class, geography, organization, and award amount band. Useful when user likes one result and wants more like it. Uses vector embeddings to find conceptually related opportunities, not just keyword matches. Available to authenticated free and paid accounts, within their search allowance. Free-plan listing-access limits still apply. Counts toward your monthly searches.

read-only

Argument	Type	Description
limit	number	Max similar opportunities to return (default: 5, max: 20)
opportunity_id*	string	ID of the opportunity to find similar matches for (from search results)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "opportunity_id"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max similar opportunities to return (default: 5, max: 20)"
    },
    "opportunity_id": {
      "type": "string",
      "description": "ID of the opportunity to find similar matches for (from search results)"
    }
  }
}

funders_for_cause

Find the private foundations that have given to recipients in a cause area, optionally limited to one state. The cause area is the IRS NTEE major group recorded for the RECIPIENT organization, so this reports where a funder has actually given rather than what it says it funds. Historical filing evidence, not an open call. Valid causes: Arts and culture (A), Education (B), Environment (C), Animals (D), Health care (E), Mental health and crisis (F), Disease and disorders (G), Medical research (H), Crime and legal aid (I), Employment (J), Food and agriculture (K), Housing and shelter (L), Public safety and disaster relief (M), Recreation and sports (N), Youth development (O), Human services (P), International affairs (Q), Civil rights and advocacy (R), Community improvement (S), Philanthropy and grantmaking (T), Science and technology (U), Social science (V), Public and societal benefit (W), Religion (X), Mutual benefit (Y), Unclassified (Z). Does not count toward your monthly searches.

read-only

Argument	Type	Description
page	number	1-based page of funders.
cause*	string	Cause area name (for example "Education") or its NTEE major group letter (for example "B").
limit	number	Funders per page (default 20, max 50).
state	string	Optional 2-letter state code for the RECIPIENT organizations, not the funder.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "cause"
  ],
  "properties": {
    "page": {
      "type": "number",
      "description": "1-based page of funders."
    },
    "cause": {
      "type": "string",
      "description": "Cause area name (for example \"Education\") or its NTEE major group letter (for example \"B\")."
    },
    "limit": {
      "type": "number",
      "description": "Funders per page (default 20, max 50)."
    },
    "state": {
      "type": "string",
      "description": "Optional 2-letter state code for the RECIPIENT organizations, not the funder."
    }
  }
}

get_account_status

Check your subscription status, usage this period, and remaining searches. Use anytime to see how many searches you have left. Does not count toward your monthly searches.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_categories

Browse all funding categories with opportunity counts. Categories include: Grant, Construction, Goods & Services, Professional Services, Technology, Healthcare, Research, and more. Useful for understanding what types of opportunities are available. Does not count toward your monthly searches.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_dataset_summary

Get dataset size and coverage stats (open opportunities, certified sources). Does not count toward your monthly searches.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_foundation

Get the current profile for a PRIVATE foundation by EIN. Foundation Intelligence Beta uses active QA-gated releases for filing-scoped public facts and Plus grant-history and repeat-grantee sections. The Pro leadership section returns only people and titles exactly as listed in a dated public filing, with responsible-use limits. The Pro federal-connections section returns registry-corroborated organization-level overlap with federal assistance records. Individual grant recipients are never named: a recipient is named only when the IRS Business Master File confirms an organization of that name in that state, and a grant purpose that may name a person is withheld. Only private foundations (IRS 990-PF filers, 3,678+ foundations) are included. Covers IRS tax years 2018 to 2026. Does not count toward your monthly searches.

read-only

Argument	Type	Description
ein*	string	9-digit EIN (no dashes). Example: 911663695. Must be a private foundation (990-PF filer).
page	number	For federal_connections, 1-based results page.
year	number	For grant_history, filter by filing year.
limit	number	Rows per paid page (default 25, max 100). Federal connections uses page-number pagination; grant history and repeat grantees return opaque cursors.
state	string	For grant_history or federal_connections, filter by 2-letter recipient state.

get_opportunity

Get details for a specific funding opportunity. Description includes up to 12,000 characters of cleaned stored source text; descriptionCoverage reports truncation and returned length. If truncated, consult the source URL. Without an mcp-session-id, the sessionless first answer returns the compact description instead: read descriptionCoverage for the returned length, the stored length and whether the text was cut, and echo the header for the full text. IMPORTANT: Use the exact "id" field from search results (e.g. "cmk65gf090028lee3nhy4lo6a"). Do NOT construct or guess IDs. Does not count toward your monthly searches.

read-only

Argument	Type	Description
id*	string	Exact opportunity ID from search results (CUID format like "cmk65gf09...")

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Exact opportunity ID from search results (CUID format like \"cmk65gf09...\")"
    }
  }
}

get_pack_link

Buy Search Pack ($5 = 50 searches, never expire). Requires active subscription. Does not count toward your monthly searches.

Argument	Type	Description
quantity	number	Number of packs to buy (1-20, default: 1). Each pack = 50 searches.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "quantity": {
      "type": "number",
      "description": "Number of packs to buy (1-20, default: 1). Each pack = 50 searches."
    }
  }
}

get_pricing

Get pricing for all plans. Returns names, prices, features, limits. Does not count toward your monthly searches.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_setup_instructions

Return MCP setup instructions for Claude Desktop and other clients. Does not count toward your monthly searches.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_tool_guide

Get comprehensive usage guide for FundingLandscape tools. Call this FIRST to understand optimal workflows, parameter usage, and best practices. Returns detailed documentation for search tools, filters, and token optimization strategies. Does not count toward your monthly searches.

read-only

Argument	Type	Description
topic	string	Topic to get guidance on (default: overview). Use "all" for complete reference.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "topic": {
      "enum": [
        "overview",
        "search",
        "foundations",
        "batch",
        "filters",
        "workflows",
        "all"
      ],
      "type": "string",
      "description": "Topic to get guidance on (default: overview). Use \"all\" for complete reference."
    }
  }
}

get_upgrade_link

Get Stripe checkout URL for subscription. IMPORTANT: Requires sign-in first. If not authenticated, returns sign-in instructions. After OAuth sign-in, call again for checkout URL. Does not count toward your monthly searches.

Argument	Type	Description
plan	string	Plan to upgrade to (default: plus)
interval	string	Billing interval (default: month)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "plan": {
      "enum": [
        "plus",
        "pro"
      ],
      "type": "string",
      "description": "Plan to upgrade to (default: plus)"
    },
    "interval": {
      "enum": [
        "month"
      ],
      "type": "string",
      "description": "Billing interval (default: month)"
    }
  }
}

list_saved_searches

List all saved searches for the current user. Returns each search with its ID, query, filters, alert settings, and last run time. Use this FIRST to check what the user already has before creating or updating searches. Response includes remaining slots and plan info. Saved searches are available on every plan, including Free (Free: 1 saved search with weekly email alerts, Plus: 10, Pro: 25). Does not count toward your monthly searches.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

report_feedback

Report bugs, data issues, or feedback. Actions: bug, data_issue, irrelevant, praise. Does not count toward your monthly searches.

Argument	Type	Description
tool	string	Which tool had the issue
action*	string	Type of feedback. Use "bug" for errors, "data_issue" for stale/wrong data, "irrelevant" for poor results.
message	string	Describe the issue. For bugs, include the error message.
category	string
severity	string	high = user blocked, medium = degraded experience, low = minor issue
request_id	string	From error response - helps us trace the issue
search_query	string	The search query that produced the issue
user_context	object
opportunity_id	string	ID of the opportunity being reported on (if applicable)
result_position

save_search

Save a search query for email alerts. When new opportunities match, the user receives daily or weekly email notifications. The FREE tier includes 1 saved search with weekly email alerts, so any user can set one up without a paid plan. RECOMMENDED WORKFLOW: 1. Call list_saved_searches first to check for existing/similar searches 2. If a similar search exists, offer to update_saved_search instead 3. Search with search_grantsplus or search_procurement first to validate the query returns good results 4. Save with appropriate filters based on what the user described FILTER TIPS: - Use itemTypes ["grant"] for grants/fellowships or ["procurement"] for contracts/RFPs - Use sourceTypes ["federal"] for federal opportunities only - Use geography ["CA"] for California-specific (includes national opportunities) - For SAM.gov-specific filters (NAICS, set-asides), use sourceContext - Keep filters broad for notifications - better to get a few extra than miss one PLAN LIMITS: Free: 1 saved search, weekly email alerts. Plus ($29/mo): 10 saved searches, daily or weekly alerts. Pro ($79/mo): 25 saved searches, daily or weekly alerts. Does not count toward your monthly searches.

Argument	Type	Description
name	string	Friendly name for this search (e.g. "DOE Clean Energy Grants")
query*	string	Search query to save (e.g. "clean energy research grants", "IT services federal contracts")
cadence	string	Alert frequency. daily requires a paid plan (Plus or Pro); free includes weekly. never = save the search without email alerts. Default: weekly
filters	object	Filters to narrow alert results. All optional. When omitted, all opportunity types are included.

search_foundations

Look up a private foundation by full legal name or EIN in the active QA-gated Foundation Intelligence release (3,678 profiles). Covers IRS tax years 2018 to 2026. Mission/topic discovery and grant-purpose search are withheld until their source and quality contracts pass review. Counts toward your monthly searches.

read-only

Argument	Type	Description
limit	number	Max foundations to return (default: 10, max: 50)
query*	string	Full private-foundation legal name or 9-digit EIN. Examples: "Gates Foundation" or "56-2618866". Mission/topic queries are not available in this release.
states	array	Filter by state (2-letter codes). Where foundation is based.
min_annual_giving	number	Minimum annual giving in dollars

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max foundations to return (default: 10, max: 50)"
    },
    "query": {
      "type": "string",
      "description": "Full private-foundation legal name or 9-digit EIN. Examples: \"Gates Foundation\" or \"56-2618866\". Mission/topic queries are not available in this release."
    },
    "states": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by state (2-letter codes). Where foundation is based."
    },
    "min_annual_giving": {
      "type": "number",
      "description": "Minimum annual giving in dollars"
    }
  }
}

search_grants_and_procurement

MIXED search across all 23,854 opportunities from 194 sources — combines grants AND procurement/contracts in one query. This mixes funding types which can create noisy results. ROUTING — use the specialized tool instead: • User wants grants/funding/fellowships/prizes → search_grantsplus • User wants contracts/RFPs/procurement/bids → search_procurement • User explicitly wants BOTH types → search_grants_and_procurement • Intent unclear → ASK the user first Use search_grantsplus or search_procurement for cleaner, more relevant results. No account needed: 25 searches and 50 full records per UTC day, counted against the mcp-session-id header that initialize returns. A free account gets 10 searches per month with full results; Plus gets 100 and Pro 1,000 per month. Paid plans see new listings in search, alerts and AI search within a day of when we add them; the free plan sees them there after 10 days. Counts toward your monthly searches.

read-only

Argument	Type	Description
limit	number	Max results (default: 10)
query	string	Natural language search query
since	string	Stateless alternative to posted_within_days/new_within_days: ISO 8601 instant. Only opportunities ingested at/after this instant. Store the previous response newSince.newest and pass it here to manage your own watermark.
cursor	string	Pagination cursor from previous response
source	string	Filter by source domain or dataSource (e.g., "grants.gov" or "tier0-sam.gov")

search_grantsplus

GRANTS & FOUNDATIONS — Search grants, prizes, fellowships, SBIR/STTR, and private foundations. Excludes procurement/contracts for clean results. Use when user wants: funding, grants, fellowships, research money, SBIR, foundation grants. Also returns matching private foundations automatically. Examples: "cancer research funding", "clean energy small business grants", "HVAC grants in Arizona". BATCH MODE (paid): pass a queries[] array of 2-5 variations instead of query to run them in parallel, dedupe, and return all unique results in one call — this replaces the former batch_search_grantsplus tool. Paid plans see new listings in search, alerts and AI search within a day of when we add them; the free plan sees them there after 10 days. Counts toward your monthly searches. A batch counts as 1 call.

read-only

Argument	Type	Description
limit	number	Max results (default: 25)
query	string	Natural language search query. Provide either query (single search) or queries (batch mode) — exactly one.
since	string	Stateless alternative to posted_within_days/new_within_days: ISO 8601 instant. Only opportunities ingested at/after this instant. Store the previous response newSince.newest and pass it here to manage your own watermark.
cursor	string	Pagination cursor from previous response
offset	number	Batch mode only: number of merged results to skip for pagination (default 0). Ignored in single-query mode.

search_procurement

CONTRACTS & PROCUREMENT — Search government contracts, RFPs, RFIs, BAAs, and solicitations from SAM.gov. Better than searching SAM.gov directly — includes semantic search and NAICS industry filtering to exclude commodity noise. Use when user wants: contracts, RFPs, procurement, bids, government work. Examples: "IT consulting services", "construction management", "cybersecurity contracts". BATCH MODE (paid): pass a queries[] array of 2-5 variations instead of query to run them in parallel, dedupe, and return all unique results in one call — this replaces the former batch_search_procurement tool. When sam_filters.place_of_performance_state (alias: pop_state, accepted in both single and batch mode) is set, the response includes a placeOfPerformance field reporting how many results are confirmed performed in that state (matched), how many have no confirmed location and are shown demoted with a caveat (unknownServed, excluded instead when user_context.location_strict is true), and how many were excluded for being tagged to a different, parseable state (otherStateExcluded; geography we could not parse into any state, such as a bare address or ZIP code, counts as unknownServed instead); a batch call sums these across every sub-query. Paid plans see new listings in search, alerts and AI search within a day of when we add them; the free plan sees them there after 10 days. Counts toward your monthly searches. A batch counts as 1 call.

read-only

Argument	Type	Description
limit	number	Max results (default: 25)
query	string	Natural language search query. Provide either query (single search) or queries (batch mode) — exactly one.
since	string	Stateless alternative to posted_within_days/new_within_days: ISO 8601 instant. Only opportunities ingested at/after this instant. Store the previous response newSince.newest and pass it here to manage your own watermark.

sign_in

Authenticate existing subscriber via OAuth. Opens browser login. Does not count toward your monthly searches.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

update_saved_search

Update a saved search. Modify query, filters, alert cadence, name, or quality settings. Can only update your own saved searches. MODIFIABLE FIELDS: query, name, filters (same schema as save_search), cadence (weekly/daily/never), hidelow (quality filter), emailEnabled (on/off) TIP: Call list_saved_searches first to see the current settings, then update only the fields that need to change. The response confirms what was updated. Does not count toward your monthly searches.

Argument	Type	Description
id*	number	Saved search ID to update
name	string	New friendly name
query	string	New search query text
cadence	string	New alert frequency. daily requires a paid plan (Plus or Pro); free includes weekly. never = turn email alerts off.
filters	object	New filters (same schema as save_search filters). Replaces all existing filters.
hidelow	boolean	Hide low-confidence results in alerts.
emailEnabled	boolean	Enable or disable email alerts without changing cadence.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "number",
      "description": "Saved search ID to update"
    },
    "name": {
      "type": "string",
      "description": "New friendly name"
    },
    "query": {
      "type": "string",
      "description": "New search query text"
    },
    "cadence": {
      "enum": [
        "weekly",
        "daily",
        "never"
      ],
      "type": "string",
      "description": "New alert frequency. daily requires a paid plan (Plus or Pro); free includes weekly. never = turn email alerts off."
    },
    "filters": {
      "type": "object",
      "properties": {
        "status": {
          "type": "array",
          "items": {
            "enum": [
              "open",
              "rolling",
              "coming_soon"
            ],
            "type": "string"
          },
          "description": "Status filter."
        },
        "sources": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Specific data sources by slug."
        },
        "geography": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "US state codes (2-letter uppercase)."
        },
        "itemTypes": {
          "type": "array",
          "items": {
            "enum": [
              "grant",
              "procurement",
              "prize",
              "financial",
              "other"
            ],
            "type": "string"
          },
          "description": "Opportunity types."
        },
        "sourceTypes": {
          "type": "array",
          "items": {
            "enum": [
              "federal",
              "state",
              "local",
              "foundation",
              "corporate"
            ],
            "type": "string"
          },
          "description": "Funding source category."
        },
        "organization": {
          "type": "string",
          "description": "Agency/organization name."
        },
        "deadlineRange": {
          "enum": [
            "next7days",
            "next30days",
            "next60days",
            "next90days",
            "noDeadline"
          ],
          "type": "string",
          "description": "Deadline window."
        },
        "sourceContext": {
          "type": "object",
          "description": "Source-specific filters (SAM.gov, Grants.gov). See save_search for details."
        },
        "applicantTypes": {
          "type": "array",
          "items": {
            "enum": [
              "nonprofit",
              "government",
              "business",
              "tribal",
              "education"
            ],
            "type": "string"
          },
          "description": "Eligible applicant types."
        }
      },
      "description": "New filters (same schema as save_search filters). Replaces all existing filters."
    },
    "hidelow": {
      "type": "boolean",
      "description": "Hide low-confidence results in alerts."
    },
    "emailEnabled": {
      "type": "boolean",
      "description": "Enable or disable email alerts without changing cadence."
    }
  }
}

whats_new

DEDICATED "what's new since I last checked" tool for recurring agent checks: one obvious call instead of remembering the new_within_days param on a search tool. Returns opportunities FundingLandscape ingested in the last N days (default 7), with a newSince summary (newCount, newest, oldest ingest timestamp). In a pure recency digest without a single source, the window is sampled across sources round-robin by ingest recency so one bulk harvester cannot own the digest; each source remains newest first. In windowCoverage, sourcesSampled counts distinct sources returned by the grouped provider query before MCP quality, judge, recency-withhold, and page filters; it is absent when no grouped sample was available, including when sampling was not attempted, and 0 means the grouped query succeeded but returned no sourced rows; sourcesServed counts distinct sources delivered on this page. windowCoverage.order is "recency" for the queryless browse digest or "relevance" when a query is present. windowIncomplete/incompleteReason reports any incomplete retrieval walk, and ceilingTruncated is true only when the 2,000-row ceiling excluded records; ceilingTruncated and hardCeiling are present only when order is "recency" and are omitted entirely under "relevance" (query mode never walks past a single bounded fetch, so no ceiling logic runs). Wraps the same ingest-freshness filter as posted_within_days/new_within_days on the search tools, no separate counting logic. Optional query/status/source narrow the window; omit query entirely for a pure recency digest across everything new. For a stateless watermark, pass since (ISO 8601) instead of days, then store this response's newSince.newest and pass it back next time. Free tier: full window, honest held-back count if the recency gate withholds anything newer. Counts toward your monthly searches.

read-only

Argument	Type	Description
days	number	Ingest-freshness window in days (default: 7). Only opportunities FundingLandscape ADDED in the last N days, not the opportunity posted date or deadline. Ignored if since is set.

FundingLandscape

Try it

batch_search_grantsplus Read-only

FundingLandscape

Try it

batch_search_grantsplus Read-only

Tools (28)