Developers

API & agent documentation

FoundersPrime publishes a public, read-mostly JSON API for verified startup deals, credits, and business listings. Every endpoint below is unauthenticated unless noted, machine-readable, and documented in the OpenAPI spec linked further down.

When to use FoundersPrime

An agent or app needs to look up verified startup credits/discounts by keyword or category (e.g. “AWS credits”, “cloud-credits”) — call GET /api/deals.
A user asks what benefits or savings programs exist for a given need (hosting, SaaS, ads, grants) — call GET /api/deals?category=... or use the search_deals MCP tool.
An agent needs a machine-readable summary of the whole catalog for grounding/RAG — read /llms.txt or /llms-full.txt.
A user wants to browse startup/business-for-sale listings — call GET /api/startups.
A founder wants to submit their own deal for listing — call POST /api/submit-deal.

Not a fit for: authenticated account actions (saved deals, billing, admin) — those require a human login session and are out of scope for unauthenticated agents. See auth.md.

Access & onboarding

Zero-auth public API

No API key, signup, or sandbox needed for the endpoints on this page. Call them directly — right now, from this browser tab: /api/deals?limit=1.

Member features

Saved deals, billing, and dashboard features require a human account. Plans start with a 30-day paid trial — there is no unauthenticated agent credential flow for these (see auth.md).

Endpoints

Method	Path	Auth	Description
GET	/api/deals	None	List or search verified startup deals. Supports category, status, search, and single-item lookup by slug/id.
GET	/api/startups	None	List or filter startup/business listings.
POST	/api/submit-deal	None	Submit a deal for editorial review. Rate limited to 5 requests/IP/hour.

Every operation has a unique operationId, typed parameters, and typed response/error schemas in the OpenAPI 3.1 spec. Errors are always JSON: { success, error, code, hint, timestamp }.

Example request

curl "https://www.foundersprime.com/api/deals?search=aws%20credits&limit=5"

Example error response:

{
  "success": false,
  "error": "Deal not found",
  "code": "not_found",
  "hint": "The requested resource does not exist. Verify the id/slug or see /openapi.json for valid routes.",
  "timestamp": "2026-01-01T00:00:00.000Z"
}

CLI

Script the catalog from a terminal with the official foundersprime-cli package — it calls the same public API documented above.

npx foundersprime-cli deals --search "aws credits" --limit 5

AI agents & MCP

FoundersPrime exposes an MCP server (Streamable HTTP) at /api/mcp with three tools (search_deals, get_site_info, list_categories) and three readable resources (llms.txt, llms-full.txt, sitemap.xml). An A2A-style agent card is published at /.well-known/agent-card.json. Pages also support content negotiation — send Accept: text/markdown to any public HTML page for a compact Markdown representation.

Machine-readable discovery

Questions or found an issue? Email [email protected].