# co-founder.net for AI agents

> co-founder.net lists startups that publicly look for a co-founder, startups hiring founding-team roles, early-stage startups from public directories (co-founder search not confirmed), and people open to co-founding — in 20 languages. Use search_startups / get_startup and search_cofounders / get_cofounder to read (free), request_introduction to ask the team for an intro (free). Paid: unlock_startup (name, website, source), order_warm_intro, order_shortlist, set_alerts — open an account with create_account (no human needed), top up with buy_credits (USDC via x402 on Base or Solana, Bitcoin Lightning, Stripe), then send the api_key as a Bearer token. Pay per call without an account: GET /agents/api/startups/{id}/unlock answers HTTP 402 (x402 / L402).

Everything here works without a human on our side: searching, reading, opening an account, paying, unlocking startups and ordering introductions.
People at co-founder.net carry out introductions and shortlists.

Listings (as of 2026-11-01): 839 startups that publicly look for a co-founder, 1116 startups hiring founding-team roles, 8600 early-stage startups from public directories (co-founder search NOT confirmed) — 10555 in all — and 125 people open to co-founding. Headlines and summaries in 20 languages (lang=en, ar, zh, es, fr, de, pt, ru, ja, ko, it, tr, nl, pl, uk, hi, id, fa, ur, vi).

## Ways in

- MCP (Streamable HTTP): https://co-founder.net/mcp — protocol 2026-07-28 (stateless, server/discover) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize).
- A2A: Agent Card https://co-founder.net/.well-known/agent-card.json (A2A 1.0) · JSON-RPC endpoint https://co-founder.net/a2a · A2A 0.3 card: https://co-founder.net/.well-known/agent.json
- WebMCP: open https://co-founder.net/agents/ in a browser with WebMCP (navigator.modelContext); the same tools are registered on that page.
- HTTP/JSON: https://co-founder.net/agents/api — OpenAPI 3.1 at https://co-founder.net/agents/openapi.json

## Tools (same names everywhere)

- **search_startups**: Search co-founder.net listings. listing_type: "cofounder" (the startup publicly looks for a co-founder), "founding" (hiring a founding-team role, a job with equity), "directory" (early-stage startup from a public directory; co-founder search NOT confirmed), or "all" (default). Returns ids, headlines in the requested language, roles, industries, place, stage, terms and page URLs. Names and sources are withheld (unlock_startup).
- **get_startup**: Full public details of one listing by id (e.g. SU-0123): headline and summary in the requested language, listing type and what it means, roles, industries, stage, funding, terms, work mode, place, team size, programme, dates and page URL. Name, website and source stay withheld (unlock_startup).
- **search_cofounders**: Search people open to co-founding (summarised from their own public posts; names and contacts withheld). Filter by role, industry, country, region, commitment and work mode, or free text (skills, background).
- **get_cofounder**: Full profile of one person open to co-founding by ref (e.g. CF-0042). Name and contact details are withheld; ask for an introduction with order_warm_intro or request_introduction.
- **list_categories**: All filter values with counts: roles (startups looking / founding roles / people), industries, regions, listing types and freshness.
- **get_service_info**: How co-founder.net works for agents: free and paid tools, prices (credits and USD), credit packs, the payment methods this server accepts (x402 USDC on Base/Solana, Lightning L402, Stripe), how to open an account, contacts and languages.
- **create_account** (sends data): Opens a co-founder.net credit account for the calling agent and returns an api_key (shown once — store it). E-mail is optional (needed only for e-mail alerts and order receipts). Send the key as "Authorization: Bearer <api_key>" (or the api_key argument) with paid tools.
- **get_account**: Your account: balance in credits, recent credit history, unlocked startup ids and orders with their status. Needs your api_key.
- **buy_credits** (sends data): Buy a credit pack for your account. method: "x402" (USDC on Base or Solana — returns the URL that answers HTTP 402; pay it with any x402 client), "lightning" (returns a BOLT11 invoice; then call confirm_payment), "stripe_spt" (pass a Stripe shared payment token in shared_payment_token; charged at once), "saved_card" (charges the card saved on this account; first time returns a setup link), "stripe_checkout" (returns a hosted payment page). See get_service_info for what this server has enabled.
- **confirm_payment** (sends data): After paying a Lightning invoice (payment_hash) or a Stripe checkout page (checkout_session), call this to add the credits to your account. Safe to repeat: credits are added once.
- **unlock_startup** (paid): Reveals the startup name, website, source URL and site, source language and the evidence quote for one listing. Paid: with an api_key it uses credits (once per startup — repeat calls are free); without an account, pay per call over HTTP 402 (x402 USDC or Lightning L402) at /agents/api/startups/{id}/unlock.
- **request_introduction** (sends data): Free introduction request to a startup (SU-…) or a person open to co-founding (CF-…). The co-founder.net team reviews it and, if it fits, contacts both sides. Returns a request_id for get_request_status. For a guaranteed, faster warm intro to a person use order_warm_intro (paid).
- **order_warm_intro** (paid): Paid service (credits): co-founder.net contacts the person behind a co-founder profile with your pitch and arranges a warm introduction if they agree. Needs an api_key with enough credits; returns an order id. Credits are returned if the person cannot be reached (see terms).
- **order_shortlist** (paid): Paid service (credits): co-founder.net searches its base and public sources for co-founder candidates matching your brief, checks their interest and sends a shortlist of people who want to talk. Needs an api_key with enough credits; returns an order id.
- **set_alerts** (sends data): Turn weekly e-mail alerts on or off for new startups looking for a co-founder or hiring founding roles, filtered by roles and countries. Each alert e-mail costs credits (see get_service_info). Needs an api_key and an account e-mail (set it with create_account).
- **get_request_status**: Status and history of an introduction request (CFI-…, with the e-mail used) or a paid order (R…, with your api_key).

## Paying (no human needed)

- Payments are not configured on this server yet.

Prices: unlock_startup 25 credits (≈ USD 28.75) · order_warm_intro 60 credits (≈ USD 69) · order_shortlist 290 credits (≈ USD 333.5) · alert e-mail 10 credits (≈ USD 11.5).

1. create_account → api_key (send as `X-API-Key: <api_key>` — or `Authorization: Bearer <api_key>` when you do not need that header for L402/MPP).
2. buy_credits (or pay per call: `GET https://co-founder.net/agents/api/startups/{id}/unlock` answers HTTP 402 with x402 payment requirements and an L402 Lightning challenge; repeat the request with the payment).
3. unlock_startup / order_warm_intro / order_shortlist / set_alerts.

## A2A messages

Exact call: one data part `{"skill": "<tool name>", "input": {…}}`. Plain text is treated as a startup search (ids like SU-0123 and CF-0042 are recognised).
Paid skills without an api_key come back as TASK_STATE_AUTH_REQUIRED with the payment options.

## Examples

MCP (2026-07-28):
```
curl -s https://co-founder.net/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' -H 'Mcp-Method: tools/call' -H 'Mcp-Name: search_startups' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_startups","arguments":{"role":"cto","listing_type":"cofounder","limit":3},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'
```

HTTP/JSON:
```
curl -s 'https://co-founder.net/agents/api/startups?role=cto&listing_type=cofounder&lang=de&limit=5'
curl -s https://co-founder.net/agents/api/accounts -H 'Content-Type: application/json' -d '{"accept_terms":true,"agent":{"name":"ExampleAgent"}}'
curl -s https://co-founder.net/agents/api/credits/buy -H 'X-API-Key: cfk_…' -H 'Content-Type: application/json' -d '{"pack":"c100","method":"lightning"}'
curl -si -X POST 'https://co-founder.net/agents/api/credits/topup?pack=c100' -H 'X-API-Key: cfk_…'   # 402 → pay with x402 / L402 / MPP → repeat
curl -si https://co-founder.net/agents/api/startups/SU-0001/unlock      # 402 → pay (x402 or L402) → repeat with the payment header
```

## Rules

- Listings are summaries of public sources; startup names, websites and sources are withheld until unlocked. "directory" listings never claim a co-founder search.
- No personal data about people open to co-founding is sold: introductions go through co-founder.net and need the person's consent.
- Write tools are rate-limited per IP. Please identify your agent in "agent": {"name", "url", "on_behalf_of"}.
- Terms: https://co-founder.net/legal/terms/ · Privacy: https://co-founder.net/legal/privacy/ · Contact: WhatsApp +49 171 1254074 · ag@brn.ai · co-founder.net · a BRNZ service · TechFunder World AG, Industriestrasse 9, 6302 Zug, Switzerland
