The Brotherhood API
Pull startup company data out of Brotherhood into your own tools, such as your CRM, a spreadsheet or a Claude agent on your own computer, and ask founders for intros that they answer in the Brotherhood app. You only ever see startups whose founders chose to share them with firms or agencies like yours, and only company-level facts: never anyone’s personal profile, name, photo, email or phone number. Agencies can also find the investors who chose to be shown to agencies: a firm’s firm-level facts, or an angel’s investment focus without their name. You contact founders and investors only through Brotherhood.
1. Who can use it
Investor firms: venture capital funds and other investor firms, such as corporate venture arms, accelerators that invest, angel networks and family offices. A firm can also have seats in the Brotherhood app.
Agencies: businesses that sell services to startups, such as recruiting, design, development, marketing, legal and accounting firms, accelerators and government programmes. Agencies have no app account: the API is how they use Brotherhood. Agencies also see the investors who chose to be shown to agencies.
Data brokers, lead resellers and anyone who wants to resell or re-publish startup data can’t get a key. Developers can build on the API for a firm or an agency; the key belongs to that firm or agency.
2. Request a key
Email admin@builderbrotherhood.com with:
- your company’s legal name and website;
- your client type: investor firm, or agency (and the services you sell);
- your intended use: what you’ll do with the data and with intro requests;
- a contact person, with a work email on your company’s domain.
Our team checks your website, your business registration and your work email, and may ask for a short call. Your company then signs the API Terms, and we issue your key. It is shown once, so keep it in a secret manager: Brotherhood keeps only a fingerprint of it and can’t show it again. Asking is free.
Test keys start with bb_test_ and work against our test environment and its demo startups. Live keys (bb_live_) come when the live API opens.
3. What you get, and what you never get
A startup appears in the API only while its founders leave sharing on for your audience: “Show to investor firms” for firms, “Show to agencies” for agencies. They can turn it off at any time; the startup then disappears from the API at once.
| Field | What it is |
|---|---|
id | A stable id |
name | The startup’s name, or “Stealth startup” when its founders chose stealth |
description | The one-line description (none in stealth) |
industries, stage | Up to 3 industries; ideation to Series C+, or bootstrapped |
city, region, country | Head office: city, province or state, country |
team_size | A band (1, 2 to 5, 6 to 10, 11+), never the exact count |
open_roles | How many roles it’s hiring for |
traction, photos | Only if the founders turned them on (photos never in stealth) |
You never get a founder’s or anyone’s personal profile, name, photo, email, phone number, messages, files, resume, application profile, anything founders prepare for a funding portal, raise terms, payment details or their activity on Brotherhood. Investment conversations and raise details aren’t available through the API.
Investors (agencies only)
Agencies can also find investor firms and angels who left “Show … to agencies through the Brotherhood API” on. Investors choose this in the app: nothing is shown until they confirm it, and any of them can turn it off at any time (for a firm, anyone at the firm); the investor then disappears from the API at once. Firm keys get 403 agency_clients_only from the investor endpoints.
| Field | What it is |
|---|---|
id, kind | An opaque stable id (never a person’s or a firm’s internal id); firm or angel |
name | The firm’s name, or always “Angel investor” for an angel |
firm_type, website, about, logo_url | Firms only |
city, region, country | A firm’s head office city and country; an angel’s city, province or state, and country |
stages, sectors | The stages and sectors they invest in |
cheque_size | The cheque size range, in whole dollars |
You never get an investor’s or anyone’s name, title, photo, email, phone number, accreditation status or documents, portfolio, messages, activity, or which startups they looked at. Never try to identify an angel.
4. Authentication and limits
Send your key in the Authorization header. Keys are server-side secrets: never put one in a web page, an app or a public repository. The API sends no CORS headers, so browsers can’t call it.
curl -s "https://emuuknbildvpwppkbelz.supabase.co/functions/v1/api/v1/me" \
-H "Authorization: Bearer $BROTHERHOOD_API_KEY"
Each key has its own limits, by default 60 requests a minute and 5,000 a day (UTC). The X-RateLimit-* headers on every answer say how many are left; over a limit you get 429 with Retry-After. Every request is logged against its key.
5. Endpoints
The test environment’s base address is https://emuuknbildvpwppkbelz.supabase.co/functions/v1/api. Every path starts with the version.
| Request | What it does |
|---|---|
GET /v1/me | Your company, your key and its limits |
GET /v1/startups | Search and filter: q, country, region, city, industries, stages, team_size, has_open_roles, named, with limit and cursor for paging |
GET /v1/startups/{id} | One startup |
GET /v1/changes?since= | What changed since your last sync: upserts and removals of startups and, for agencies, investors |
POST /v1/startups/{id}/intro-requests | Ask a startup’s founders for an intro |
GET /v1/investors | Agencies only. Search and filter investors: kind (firm or angel), stages, sectors, country, cheque (a whole-dollar amount within their range), with limit and cursor |
GET /v1/investors/{id} | Agencies only. One investor |
POST /v1/investors/{id}/intro-requests | Agencies only. Ask an investor for an intro |
GET /v1/intro-requests/{id} | The status of one of your intro requests, to a startup or an investor |
Answers and errors are JSON. The full description, with every field, is in the OpenAPI document we send with your key.
6. Keeping in sync
GET /v1/changes lists, oldest first, every startup (and, for agencies, every investor) that is new or changed for you (upsert, with it as it is now) and every one you may no longer see (removed, with no reason given). Each entry says its kind: startup or investor. Keep the next_since it returns and send it as since next time; without since you get everything shared with you now.
When a startup or an investor is removed, you must delete what you copied about it within 30 days. Syncing at least once a day keeps you well inside that.
7. Intro requests
An intro request is a short message (20 to 500 characters) and what you offer the startup. It arrives in the founders’ Requests in the Brotherhood app, labelled with your company’s name and whether you’re an agency or a firm. They accept or decline.
curl -s -X POST "$BROTHERHOOD_API_URL/v1/startups/$STARTUP_ID/intro-requests" \
-H "Authorization: Bearer $BROTHERHOOD_API_KEY" -H "Content-Type: application/json" \
-d '{"message": "We place senior engineers at seed-stage startups and would like to help you hire.",
"help": ["hiring_help"]}'
- Agencies offer their services: at most 3 requests per startup a week (shared by every agency) and 20 a day per key.
- Investor firms ask for advice or a co-founder intro: at most 10 waiting at a time and 10 new ones a month.
- One open request per startup, and 90 days before you can ask again after a decline. A request expires after 14 days.
- When founders accept, a firm with app seats gets a chat in the app with its contact; an agency reads the founders’ reply through the API, and the founders see its website and contact email. A decline, an expiry and a withdrawal all read
closed.
Founders can stop agency requests or block you at any time.
Agencies can also ask an investor for an intro (POST /v1/investors/{id}/intro-requests, a message of 20 to 500 characters). It arrives in the investor’s Messages › Requests in the Brotherhood app, labelled “Agency” with your company’s name; for a firm, everyone at the firm sees it and the first to answer answers for the firm. At most 3 requests per investor a week (shared by every agency), one open request per investor, and the same 20 a day per key. When an investor accepts, they see your website and contact email in the app. Investors can stop agency requests or block you at any time.
8. The MCP server
The Brotherhood MCP server lets Claude, or any client that speaks the Model Context Protocol, use the API as tools: search_startups, get_startup, list_changes, send_intro_request, get_intro_request and, with an agency key, search_investors, get_investor and send_investor_intro_request. It runs on your own computer with your key, which it sends only to the Brotherhood API. We send it to you with your key.
{
"mcpServers": {
"brotherhood": {
"command": "node",
"args": ["/path/to/brotherhood-mcp/dist/index.js"],
"env": {
"BROTHERHOOD_API_KEY": "bb_test_…",
"BROTHERHOOD_API_URL": "https://emuuknbildvpwppkbelz.supabase.co/functions/v1/api"
}
}
}
}
claude mcp add brotherhood \
--env BROTHERHOOD_API_KEY=bb_test_… \
--env BROTHERHOOD_API_URL=https://emuuknbildvpwppkbelz.supabase.co/functions/v1/api \
-- node /path/to/brotherhood-mcp/dist/index.js
send_intro_request and send_investor_intro_request reach real people, so the server tells the model to show you the message and wait for your go-ahead before sending it.
9. The rules
The API Terms your company signs are the contract. In short:
- Use what you get to evaluate startups and offer them your investment interest or your services (agencies: and to offer investors your services). You may copy it into your own tools.
- Never sell, license, rent, broker or re-publish it, or give it to anyone outside your company. Never use it to identify a stealth startup, a founder or an angel investor, or to build a list for resale.
- Contact founders and investors only through Brotherhood, unless they give you their details.
- Keep it secure, and tell us at privacy@builderbrotherhood.com within 72 hours of any breach.
- Delete a startup’s or an investor’s data within 30 days after the changes feed reports it removed, and everything within 30 days after your access ends.
- Keep your key secret and respect its limits. Tell us at once if it leaks, and we’ll replace it.
- Agencies’ messages say who they are and what they offer, and follow Canada’s anti-spam law and Quebec’s privacy law.
- Fees are for access only, never a share of a deal, an investment or a sale. We may audit your use and revoke a key at once if the rules are broken.
10. Errors and support
Errors are JSON with a stable code, for example {"error": {"code": "intro_cap_reached", "message": "…", "detail": "startup_week"}}. The codes you’ll meet most: invalid_key and key_revoked (401), agency_clients_only (403: investors are for agency keys), not_found (404: not there, or not shared with you), intro_open (409), and rate_limited and intro_cap_reached (429). Every answer carries an X-Request-Id to quote if you write to us.
Within version 1 we only add things; we’ll announce anything that breaks your integration at least 90 days ahead. Questions, access and higher limits: admin@builderbrotherhood.com.