whoami
Return the authenticated Cofound account: email, public handle, profile state, and auth_method (oauth or static_token).
LABSCO SUMMARY
Silent blocks and opaque not-found responses are a deliberate defence against exactly the automation this API enables.
Give agents a directory of people and a send tool, and the failure mode is obvious. Cofound's answers are structural: first-messages are capped per rolling day, blocks are invisible to the blocked party, and hidden profiles return not-found rather than access-denied — so an agent cannot map who has blocked whom by probing. get_thread being documented as having side effects is the same honesty: reading marks messages read, and a tool that quietly changes state should say so.
What it is
Cofound's endpoint, 13 tools in four groups: profile, search, messaging and blocks. The design is unusually careful about what the other side can infer.
What you get
- whoami, get_profile, update_my_profile, submit_raw_profile — read and patch your profile, or hand over freeform text for normalisation
- set_profile_state — active or paused; deletion is website-only
- search_profiles — reciprocal, ready, non-blocked public profiles, by structured filters only
- send_message, list_threads, get_thread, list_sent — messaging, with reading a thread explicitly marked as having side effects
- block_profile, unblock_profile, list_blocks — idempotent, and blocks are silent: a hidden target returns an opaque not-found
Requirements
A Cofound account. Free at $0 a month, with caps: 20 first-messages to new contacts per rolling 24 hours, each slot reopening 24 hours after use. Replies in existing threads are not capped the same way.
Setup effort
Paste a URL, then sign in — add the endpoint to your client and sign in to Cofound Agent
USE CASES
01
Finding a co-founder by criteria
Search the directory with structured filters, seeing only reciprocal, ready and non-blocked profiles.
02
Reaching out without burning the cap
First-messages are limited to 20 per rolling day, so drafting matters more than volume.
03
Triaging replies without marking them read
List thread metadata first; opening a thread has side effects.
04
Stepping back
Pause the profile rather than deleting it — deletion is website-only.
13 tools
Listed in project docs. Your client may show a different list.
get_profile
Read a private owner profile or an opaque public profile projection; public reads hide non-visible targets as not_found.
update_my_profile
Patch only writable profile, idea-slot-0, and location fields; unknown/read-only/invalid fields rejected.
submit_raw_profile
Submit freeform profile text through the synchronous normalizer (text only; no binary uploads; 20/day anti-abuse cap).
set_profile_state
Set caller profile state to active or paused (deletion is website-only).
search_profiles
Search reciprocal, ready, non-blocked public profiles using structured filters only; returns {profile, match} with complementarity_score, distance_km, timezone_diff_hours, ordered by score.
send_message
Send a message preserving silent-block opacity and contact caps (first-messages to new contacts capped per rolling 24h; replies uncapped).
list_threads
List message thread metadata without marking messages read (triage entry point).
get_thread
Read one thread and mark delivered counterparty messages as read (has side effects).
list_sent
List authored messages without side effects or exposing silent-block delivery state.
block_profile
Idempotently block a visible profile; hidden targets return opaque not_found.
unblock_profile
Idempotently unblock a profile.
list_blocks
List currently visible profiles blocked by the caller.
BEFORE YOU INSTALL
What to know first
Tools you get
13 tools named in the project's documentation.
Requires
an MCP client that can reach a remote endpoint
INSTALLATION
Connect your client
Add the endpoint to your client and sign in to Cofound Agent.
Server setup
ENDPOINT URL
https://mcp.cofoundagent.ai/mcp
