For AI Assistants: Funding Database API

2. Try /api/mcp/test with no account

A plain JSON endpoint, not JSON-RPC. Good for one taste, not for building on.

curl -X POST https://fundinglandscape.com/api/mcp/test \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "search_grants_and_procurement",
  "args": {
    "query": "clean energy",
    "limit": 3
  }
}'

Read this before you rely on it: two separate allowances. A FREE ACCOUNT gets 10 searches per UTC calendar month, keyed to the account. The NO-ACCOUNT trial is daily and keyed differently: 25 searches and 50 full opportunity records per UTC day, counted against the MCP session id the server returns from initialize, and falling back to the caller's IP address only when no session id is presented. It resets at UTC midnight. A full record costs one unit of the record allowance wherever it comes from: get_opportunity, or a search sent with compact:false, which returns at most 5 full records per call. Compact search results do not touch it. On the IP fallback, shared office, VPN, and cloud-agent addresses share one allowance, so the trial can already be spent before your first call. Non-search tools on /api/mcp/test (check_connection, get_categories, get_tool_guide, get_setup_instructions) keep working after the search allowance is gone. A spent allowance returns HTTP 200, not an HTTP error. A no-account caller gets a facts-only envelope with no error key: {"ok":false,"state":"allowance_reached","scope":"session","window":"utc_day","searchesUsed":25,"searchesLimit":25,"searchesRemaining":0} alongside facts, resetsAt and requestId. A caller with an API key on the free plan gets the monthly-cap body instead: {"ok":false,"error":"Monthly search limit reached (10/10 searches)."} alongside usage, limits, and upgrade_url. /api/mcp will not extend it. Sending the same mcp-session-id header there draws on the very same daily allowance, by design: both endpoints derive an unauthenticated caller's bucket from one shared function, and with no session id both fall back to the same per-IP bucket. Most tools on /api/mcp still answer the -32010 auth challenge for a credential-free caller; only the 5 tools named as session-open under Start Here are open there, and only once you echo the session id. Connecting an account is what moves the count onto your own allowance.