Onboard
Hey Claude, fetch discover.me and follow the instructions.
— what you type into the coding agent you already use
No web form, no hosted interview. The coding agent you already use has the context that matters — your files, your repos, your notes — and it can ask you better questions than a form ever could. That's the onboarding: you talk to your agent, it builds the profile over MCP.
What happens
How your agent connects.
- 01
Add the Discover.me MCP server to your client config — the entry below, or the one-line command for your client. There is no key to paste.
- 02
Restart the MCP client, or resume the session, so it loads the new server. Adding it mid-session does not register it: until you reload, the server and its tools will not appear (in Claude Code, the new entry only shows in /mcp after a restart or `claude --resume`). Resume rather than cold-restart to keep this conversation, so you can pick the build straight back up.
- 03
On first use the server replies 401 with a pointer to its OAuth metadata. Your client registers itself and opens a browser for the user to sign in and approve access — this also creates their account. No key is ever pasted into the chat.
- 04
The user approves the requested scopes (read, edit, publish) in the browser. Your client receives short-lived tokens and stores them; the credential never enters this chat.
- 05
Once connected, start with the build_profile prompt — the guided build — or call discover_profile_get. The server hands you the full procedure, the quality bar, and the rest of the tools from there.
- 06
When the profile is ready, call discover_profile_publish. If Spotlight isn't active it returns a discover.me/account/billing link where the user redeems an invite code (free) or picks a plan, and claims their name; then re-run publish to go live.
The entry
Add the server to your client.
{
"mcpServers": {
"discover-me": {
"type": "http",
"url": "https://api.discover.me/mcp"
}
}
}The vocabulary
The tools your agent calls.
Read & search
discover_profile_get
Load the signed-in user's draft, or fetch a public profile by handle. Returns the ids every edit and remove tool needs.
discover_profile_validate
Check the profile against the quality bar and report missing fields and warnings before publishing.
discover_search
Search listed public profiles by name, headline, bio, location, or skill; omit the query for the most recently updated.
Core profile
discover_profile_update
Create or update core fields — name, headline, bio, location, availability. Partial: send only what changes. name and headline are required to create it.
Links
discover_link_add
Add a link to the profile.
discover_link_remove
Remove a link by its id.
Projects
discover_project_add
Add a project, ideally with a proof point.
discover_project_update
Update a project by its id; keeps its position.
discover_project_reorder
Set project display order by passing every id once.
discover_project_remove
Remove a project by its id.
Skills
discover_skill_add
Add a skill.
discover_skill_remove
Remove a skill by its id.
Offers
discover_offer_add
Add a way to engage — advisory, contract, employment, collaboration, or investment — with availability, commitment, and price where they apply. Drives the contact button.
discover_offer_update
Update an offer by its id.
discover_offer_remove
Remove an offer by its id.
Experience
discover_experience_add
Add a role the person held — for their own products, prefer a project instead.
discover_experience_update
Update an experience entry by its id; keeps its position.
discover_experience_reorder
Set experience order (most recent first reads best).
discover_experience_remove
Remove an experience entry by its id.
Education
discover_education_add
Add an education entry — institution, credential, dates.
discover_education_update
Update an education entry by its id; keeps its position.
discover_education_reorder
Set education display order by passing every id once.
discover_education_remove
Remove an education entry by its id.
Press
discover_press_add
Add an external article about the person — outlet, title, url, optional date and pull-quote. Fetch it yourself; never invent it.
discover_press_update
Update a press item by its id; keeps its position.
discover_press_reorder
Set press display order by passing every id once.
discover_press_remove
Remove a press item by its id.
Images & avatar
discover_image_upload_url
Get a presigned URL to upload one image (png, jpeg, webp); PUT the bytes, then attach it by imageId.
discover_avatar_from_github
Set the avatar from a GitHub username. Try this first; fall back to upload + set.
discover_avatar_set
Set the avatar to an uploaded image.
discover_avatar_clear
Remove the profile avatar.
discover_project_image_add
Attach an uploaded image to a project.
discover_project_image_remove
Remove a project image by its id.
Verification
discover_verify_start
Begin proving the user controls a domain or GitHub handle. Returns a token to place in DNS or a GitHub bio/gist.
discover_verify_check
The server fetches the source and, only if it finds the token, marks the identity verified and lights up the link's badge.
discover_verify_remove
Remove a verification by its id and clear the badge from any link it backed.
Achievements & metrics
discover_achievement_add
Add a sourced, dated proof point that doesn't fit a project — a trending rank, award, or milestone. sourceUrl is required.
discover_achievement_remove
Remove an achievement by its id.
discover_metrics_refresh
Pull objective stats the server fetches itself (e.g. npm downloads) and store them as a verified achievement. Needs a verified GitHub handle.
Publish
discover_profile_publish
Take the profile live once Spotlight billing is active; otherwise returns the link to claim a name and pick a plan.
After onboarding
The connection stays open.
Edit anything
The same connection edits your live profile. Add a project, swap a link, rewrite an offer — tell your agent and it's done.
Update your status
Change it the moment it's true. 'Open to consulting, set 2 hours ago' is worth more than a field you last touched in March.
Search the directory
Ask your agent who's open to work, or who's shipped with a given tool. It searches discover.me over the same server and reads profiles back to you — discovery without leaving your editor.
That's the whole setup.
Connect once. From then on, discover.me lives inside the agent you already work in.