Foundaree in ChatGPT and Claude

Just ask. Nothing to install. Or connect it, and let it do the whole job for you.

We are building Foundaree so anything you can do here, your assistant can do for you. What we are building.

Just ask

Open ChatGPT, Claude, Gemini or Perplexity. Turn on web search if it asks. Then ask:

  • Find a dentist in Pune on foundaree.com
  • Find a React developer in Bengaluru on foundaree.com
  • Find an electrician in Kochi who is free today on foundaree.com
  • Who is open to co-founding a startup on foundaree.com?

They read Foundaree's public pages, the way Google does. Only public profiles show up.

If it says it can't find Foundaree, paste a link for it to read, like https://foundaree.com/search?q=dentist+in+Pune. Foundaree is new, and web search takes a few weeks to pick up a new site.

What you get

Real profiles

Name, skills and city, as people wrote them.

Who is free

People say when they are free and keep it up to date.

Every kind of work

Doctors, developers, drivers, designers, electricians and accountants in one search.

Connect Foundaree (optional)

For searching inside the chat, with profile cards. One link works in every assistant that takes a custom connector. In Claude it takes a minute; in ChatGPT it needs Developer mode until Foundaree is in ChatGPT's app directory.

Copy this link:

https://foundaree.com/mcp

Step by step, one page each: ChatGPT, Claude, Gemini, Perplexity, Grok, and your own agent.

ChatGPT

  1. 1Open Settings → Apps & Connectors → Advanced.
  2. 2Turn on Developer mode.
  3. 3Go back and tap Create.
  4. 4Name it Foundaree and paste the link as the URL.
  5. 5Authentication: choose OAuth so it can act for you, or None for search only.
  6. 6Ask: Find an electrician in Kochi on Foundaree

Claude

  1. 1Open Settings → Connectors.
  2. 2Tap Add custom connector.
  3. 3Name it Foundaree and paste the link as the URL.
  4. 4When Claude offers to connect your Foundaree account, tap it and then Allow. (Skip it for search only.)
  5. 5Ask: Find a React developer in Bengaluru on Foundaree

Claude Code

Two commands. Foundaree is in Claude's plugin directory, with skills that know when to use it.

/plugin marketplace add shujahmhd/foundaree-plugin
/plugin install foundaree@foundaree

Any other assistant

Same link, different menu. Foundaree is a standard MCP server, so anything that takes a custom connector can use it — no app store, no waiting for us.

  • PerplexitySettings → Connectors, on a paid plan
  • Mistral Le ChatSettings → Connectors
  • Microsoft CopilotThrough your Microsoft 365 admin
  • GeminiSettings → Connected apps (personal accounts, US today)
  • Cursor, Windsurf, VS CodeAdd it as an MCP server

Which plans allow custom connectors is each app's own rule, and it changes. If yours isn't listed, look for “MCP” or “custom connector” in its settings.

Only public profiles show up.

Let it do the whole job

You don't have to pick a person. Say what you need, and Foundaree finds the right people, asks the best one or two, and tells you who was asked.

Sort out an electrician in Kochi for Saturday morning. I'm Deepa, +91 98470 12345.

  1. 1Foundaree searches, with people who are free now first.
  2. 2It sends a booking request to the best one or two, with your name and number.
  3. 3Your assistant tells you who was asked. Whoever can take it calls you.

Later, ask:

Did anyone get back to me?

Nothing is confirmed until someone calls you. Your number goes only to the people asked.

Sign in, so it can act for you

Searching needs no account. Connect your Foundaree account once, and your assistant can also:

  • See who wants to book you, and accept or decline for you
  • See who wants to connect, and answer them
  • Mark you free for work, or not, when you say so

Your assistant offers to connect when it needs to. A Foundaree page opens, you check what it will be allowed to do, and tap Allow. That's it.

It never sees your password. It gets a key, not the keys to the house.

Take the key back any time: Settings → Assistants you connected. It stops that second.

Join through your assistant

Add Foundaree to your assistant first. Then ask:

Put me on Foundaree as a home nurse in Kochi.

  1. 1Your assistant makes a draft and gives you one link.
  2. 2Open the link and check your profile.
  3. 3Sign in and tap Publish.

Nobody sees your draft until you publish it.

For developers

Three ways to find people. One way to help someone join.


JSON API

A public, read-only search endpoint. No key needed. Send a GET request, get JSON back.

Example request

GET https://foundaree.com/api/search/people?q=electrician&location=Kochi&availability=available

Example response

{
  "items": [
    {
      "username": "example-username",
      "name": "[Name]",
      "headline": "Electrician, homes and offices",
      "location": "Kochi, India",
      "availability": "available",
      "skills": ["Wiring", "Inverter installation", "Fan and light fitting"],
      …
    },
    …
  ],
  "total": 4,
  "limit": 20,
  "offset": 0
}
Query parameters for the people search endpoint
ParameterDescription
qFree text: a skill, role, profession or name. A plain sentence works too.
workTypelocal_service for trades, repairs, driving and care. professional for office work.
locationA city or country, matched against where the person says they are.
availabilityOne of available, open_to_offers, not_looking or unspecified.
skillsComma-separated list. A profile must list every skill given.
lookingForComma-separated list of what the person wants, such as freelance or remote. All must match.
limitResults per page, 1 to 50. Defaults to 20.
offsetNumber of results to skip when paging. Defaults to 0.

At least one filter is required. Results include public profiles only.


MCP server

Model Context Protocol, for assistants that support it. Fourteen tools. Seven need no sign-in: search_people takes the same filters as the JSON API, match_people ranks people against a list of skills, get_person returns one full profile by username, search_organizations finds companies, search_opportunities finds jobs and other openings, create_profile_draft starts a profile for someone who asks to join, and request_appointment sends a booking request to a person, who calls the user back.

Five more work only once the user has connected their Foundaree account, and act as them: my_bookings and respond_to_booking for the requests they have been sent, my_connection_requests and respond_to_connection for people waiting to connect, and set_my_availability for whether they are free for work. Without a token they refuse and say so.

And two that take the whole errand: find_and_ask searches, ranks, asks the best one to three people and reports who was asked, so the assistant never has to pick a person itself; check_errand says later who accepted. No account needed.

Endpoint

https://foundaree.com/mcp

Public. No key needed. Drafts stay private until the person publishes. Listed in the official MCP Registry as io.github.shujahmhd/foundaree. Server card: /.well-known/mcp.json. Add it to ChatGPT or Claude


Help someone join

Any agent can start a profile for a person who asks. Send only what they said about themselves. Give them the link you get back.

Example request

POST https://foundaree.com/api/agent/profile-drafts
{
  "name": "[Name]",
  "category": "nurse",
  "location": "Kochi",
  "area": "Kakkanad",
  "skills": ["Pipe fitting", "Leak repair"],
  "whatsapp": "[Number]"
}

Example response

{
  "finishUrl": "https://foundaree.com/finish-profile#token=…",
  "expiresAt": "…",
  "summary": "Draft profile for [Name], home nurse in Kakkanad, Kochi. …"
}

No key needed. Nothing is public until the person signs in and publishes. The link works once.

What you can't get

  • Private or hidden profiles. They never show up.
  • Drafts. Nobody sees one until the person publishes it.
  • Sign-in emails, and any phone number or email the person keeps private.
  • Bulk export. Results come one page at a time, up to 10,000.

Rate limits apply per caller.

Fair use

  • Name your agent in the User-Agent header.
  • Respect the rate limits. Back off on a 429 response.
  • Link to Foundaree profiles. Don't copy them into your product.
  • No bulk outreach, list building or spam.
  • Follow the Community guidelines and the Terms.

Want to be found?

People search here and in ChatGPT and Claude.

Add your profile