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.
No coding agent?
Talk to Lisa instead. She interviews you in the browser and writes your profile while you talk — sign in and she saves it as you go.
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.