MCP
The Model Context Protocol surface GFIN serves. This page renders the same catalogue the server registers, so the tool list and the server cannot disagree.
Status
The endpoint is served at https://app.gofunditnow.com/api/mcp. On 2026-11-12 a tools/list request to the production deployment answered 200 and listed the two public tools, and a tools/call returned catalogue rows. A host connector such as ChatGPT, Claude or Grok connects anonymously and reaches those two tools only.
Reaching the endpoint in a deployment requires CHATGPT_MCP_ENABLED. The anonymous lane is a second arm, CHATGPT_MCP_PUBLIC_ENABLED. With the master gate unset the route answers 404, exactly as if it did not exist.
The connected tools answer to a GFIN account's own access token. They are session-only by policy (D-116): a host connector is not offered them, and no OAuth private-tool lane is built for this release. OAuth authorization server configuration remains an owner decision and is not a capability this page presents as available.
gfin_ API key read the public catalogue; a signed in user's bearer token reads that user's own organization. The key is for a local MCP client, not a host. The connected mode is a GFIN app session holding the account's token, never a host connector.Read Using GFIN from an AI assistant before a call. It covers the two lanes, which tool answers which question, deadline honesty, the access block, the credit model and the hand-off to the app. The plain-text copy is at /developers/mcp/guide.txt.
The endpoint
The BFF serves one endpoint at /api/mcp, on the same origin as the application. The transport is MCP Streamable HTTP: one POST carries one JSON-RPC 2.0 request and answers application/json. Server sent events are not implemented. GET, DELETE, PUT and PATCH answer 405 with Allow: POST, OPTIONS; OPTIONS answers 204.
The protocol version is 2025-06-18. The server identifies itself as GFIN Funding Radar version 2.0.0.
These samples show the wire shape only. They answer 404 until the endpoint is armed, so a request sent today is a test of the gate rather than a result.
Tools
The server registers 7 tools. Each one reads an endpoint the product already serves. None of them re-ranks opportunities or re-checks eligibility on a second path, and none of them accepts an organization from the model as proof of membership. A keyword or a filter runs the product's own live ranking lane and the answer says so; a plain request reads the dashboard snapshot.
| Tool | Callable by | Read or write |
|---|---|---|
| search_opportunities | Anonymous, API key or signed in user | Read |
| get_opportunity | Anonymous, API key or signed in user | Read |
| get_organization_profile | Signed in user only | Read |
| list_pipeline | Signed in user only | Read |
| get_project_requirements | Signed in user only | Read |
| save_opportunity | Signed in user only | Write |
| get_my_saved_opportunities | Signed in user only | Read |
search_opportunities
Returns funding opportunities. An anonymous connection searches the public catalogue; a connected account gets its own admitted matches. A keyword query uses the product's live ranking lane and the answer says live.
Callable by: Anonymous, API key or signed in user. Read or write: Read.
- query optional Optional keywords. Omit for this organization's best admitted matches. A query uses the product's live search lane and is slower.
- state optional Optional two-letter US state code. When the request names a US state, pass its code; the catalogue is not US-only, so omitting it returns recent rows from every geography.
- funding_types optional Optional canonical funding-type ids.
- deadline_days optional Only rows closing within this many days.
- limit optional Rows to return. Defaults to 12.
get_opportunity
Returns one opportunity the caller is allowed to see, with its stored deadline, amount, eligibility factors and source link.
Callable by: Anonymous, API key or signed in user. Read or write: Read.
- opportunity_id required The opportunity id returned by search_opportunities.
get_organization_profile
Returns the connected organization's minimal funding profile: name, type, location, focus areas, profile completion and entitlement capabilities.
Callable by: Signed in user only. Read or write: Read.
This tool takes no arguments.
list_pipeline
Lists the organization's funding pursuits with their status, next deadline and requirement progress.
Callable by: Signed in user only. Read or write: Read.
- limit optional Pursuits to return. Defaults to 10.
get_project_requirements
Returns the requirements of one pursuit, each with its category, priority, status and the source excerpt that states it.
Callable by: Signed in user only. Read or write: Read.
- project_id required The pursuit id returned by list_pipeline.
save_opportunity
Saves one opportunity to the organization's saved list through the same favorite row the product's Save control writes.
Callable by: Signed in user only. Read or write: Write.
- opportunity_id required The opportunity id returned by search_opportunities.
get_my_saved_opportunities
Returns the opportunities this account has saved, newest first, with the same source-grounded fields as search.
Callable by: Signed in user only. Read or write: Read.
- limit optional Saved rows to return. Defaults to 10.
What is not here
The HTTP surface on /v1 is larger. Documents, jobs, usage, webhooks and the Funding Intelligence Report with its exports are HTTP operations, not MCP tools, and this page does not present them as tools. A capability becomes a tool only when an existing endpoint already performs the action, so the connector never invents a workflow to fill a table.