Servidor MCP

Foundaree

io.github.shujahmhd/foundaree
Negocio y operaciones Ventas y CRM Público y accesible MCP 2025-11-25

Qué hace este MCP

Searches public profiles and organizations, matches people to requirements, and manages booking and connection requests.

check_errand
See who answered an errand
Check on an errand started with find_and_ask: which of the people asked have accepted, declined or not answered yet. Use it when the user asks "did anyone get back to me?". Someone who accepted will call the user on the number they gave; Foundaree does not arrange the time.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['errandId'], 'properties': {'errandId': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'The errandId that find_and_ask returned.'}}}
create_profile_draft
Put the user on Foundaree
Start a Foundaree profile for the user. Use it only when the user asks to join Foundaree, to be listed on it, or to create their own profile. Fill in only details the user gave about THEMSELVES: never about someone else, and never guess. Only `name` is required. Nothing is published: this saves a private draft and returns one link (finishUrl). The user opens it, checks the profile, signs in and taps Publish; until then nobody can find it. Show the user the link. It works once, for 7 days. Nobody is emailed or texted.
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name'], 'properties': {'bio': {'anyOf': [{'type': 'string', 'maxLength': 10000}, {'type': 'null'}], 'description': 'A few sentences about them: experience, languages, the work they take.'}, 'area': {'anyOf': [{'type': 'string', 'maxLength': 120}, {'type': 'null'}], 'description': "Neighbourhood or area they work in within the city, e.g. 'Kakkanad'."}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': "The person's own name, as they gave it."}, 'phone': {'anyOf': [{'type': 'string', 'pattern': '^[0-9+\\s-]+$', 'maxLength': 20}, {'type': 'null'}], 'description': 'Their phone number, with the country code when they gave one. Shown only if they choose so when publishing.'}, 'skills': {'type': 'array', 'items': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'maxItems': 50, 'description': "Skill names, e.g. ['Pipe fitting', 'Leak repair']."}, 'intents': {'type': 'array', 'items': {'enum': ['job', 'cofounder', 'freelance', 'internship', 'project', 'advisory', 'other'], 'type': 'string'}, 'default': [], 'maxItems': 7, 'description': 'What they are open to.'}, 'category': {'anyOf': [{'type': 'string', 'maxLength': 60}, {'type': 'null'}], 'description': 'Their trade or job as a short lowercase slug, e.g. plumber, electrician, carpenter, driver, cleaner, tutor, software-engineer, designer, accountant.'}, 'headline': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}], 'description': 'One short line about their work, in their words.'}, 'location': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}], 'description': "Their city, e.g. 'Kochi' or 'Kochi, Kerala'."}, 'whatsapp': {'anyOf': [{'type': 'string', 'pattern': '^[0-9+\\s-]+$', 'maxLength': 20}, {'type': 'null'}], 'description': 'Their WhatsApp number. Shown only if they choose so when publishing.'}, 'githubUrl': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}], 'description': 'Their GitHub page (http:// or https://).'}, 'lookingFor': {'type': 'array', 'items': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'default': [], 'maxItems': 20, 'description': "The kind of work they want, as short tags, e.g. ['weekend jobs']."}, 'linkedinUrl': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}], 'description': 'Their LinkedIn page (http:// or https://).'}, 'availability': {'enum': ['available', 'open_to_offers', 'not_looking', 'unspecified'], 'type': 'string', 'description': 'available = free now; open_to_offers = open to work; not_looking = not looking right now.'}, 'portfolioUrl': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}], 'description': 'Their own website (http:// or https://).'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['finishUrl', 'expiresAt', 'summary'], 'properties': {'summary': {'type': 'string', 'description': 'One line: whose draft it is, and that nothing is public yet.'}, 'expiresAt': {'type': 'string', 'description': 'When the link stops working (ISO 8601).'}, 'finishUrl': {'type': 'string', 'description': 'The link to give the user: they check the profile, sign in and publish there.'}}, 'additionalProperties': False}
find_and_ask
Find the right people and ask them, in one go
Hand the whole errand to Foundaree: "find me a plumber in Kochi for Saturday morning". Foundaree searches, ranks the way its website does (people free now first), sends a booking request to the best one to three, and reports who was asked. Use this instead of search_people + request_appointment when the user wants it sorted rather than a list to choose from. Needs the user’s OWN name and phone number, which they gave you, and their clear yes before calling: real people will be contacted. Each person asked calls the user back if they can take it; nothing is confirmed until they do, so say that. Keep the returned errandId and use check_errand later to see who said yes. No account needed.
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'phone', 'need', 'when'], 'properties': {'area': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'Neighbourhood, e.g. Kakkanad. Optional.'}, 'name': {'type': 'string', 'description': "The user's own name, as they gave it."}, 'need': {'type': 'string', 'description': 'What the user needs done, in a sentence or two.'}, 'when': {'type': 'string', 'description': "When they would like it, in plain words, e.g. 'Saturday morning' or 'today after 5 pm'."}, 'phone': {'type': 'string', 'pattern': '^[0-9+\\s-]+$', 'maxLength': 20, 'description': "The user's own phone number, with country code when known, e.g. +91 98470 12345. The person calls back on it."}, 'howMany': {'type': 'integer', 'default': 2, 'maximum': 3, 'minimum': 1, 'description': 'How many people to ask, 1 to 3. Two is a good default: a choice without pestering.'}, 'language': {'type': 'string', 'maxLength': 40, 'minLength': 1, 'description': 'Only ask people who work in this language, e.g. Malayalam. Leave out if any language is fine.'}, 'location': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'City, e.g. Kochi. Strongly recommended.'}, 'workType': {'enum': ['local_service', 'professional'], 'type': 'string', 'description': 'local_service for trades, repairs, driving and care; professional for office work. Leave out if unsure.'}}, 'additionalProperties': False}
get_person
Get a person profile
Retrieve the full public profile for a username, including skills, experiences, projects, `services` (what they offer with prices: name, price in whole currency units or null for "ask", currency, per job/hour/day/visit/session/month, from = starting price, note), `licence` (a registration number Foundaree's admin looked up on its public register, e.g. a doctor's NMC number: body, number, checkedAt; only once verified, and then "licence" is also in `verifiedBy`), and the phone, WhatsApp and contact email (`phone`, `whatsapp`, `contactEmail`) when the person made them public. `workProof`, when at least one kind is proven, is a count, not a score: "Proof: `proven` of `total`" over GitHub, website and LinkedIn (LinkedIn has no proof yet), with the facts of each proven one: `github` (public facts of a GitHub account they proved is theirs by signing in with it: repos, stars, followers, top languages, last push, and when Foundaree read them) and `website` (their website links back to this profile). `person.updatedAt` is when they last edited the profile. Returns structured JSON with `success`, `found` and `person` fields. Each answer has two views: the text content is the JSON described above, and the structured content is a profile-card list (`people`, `total`, `query`). In apps that support MCP Apps (ChatGPT, Claude) the cards render as Foundaree profile cards. A person with `foundareeRole` ("founder" or "team") is part of Foundaree's own team; only Foundaree sets it.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['username'], 'properties': {'username': {'type': 'string', 'maxLength': 48, 'minLength': 1, 'description': 'Username of the person, e.g. "maya-chen"'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['people', 'total', 'query'], 'properties': {'query': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'total': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'people': {'type': 'array', 'items': {'type': 'object', 'required': ['username', 'name', 'availability', 'workType', 'skills', 'profileUrl'], 'properties': {'area': {'type': 'string'}, 'name': {'type': 'string'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'trade': {'type': 'string'}, 'backed': {'type': 'array', 'items': {'type': 'string', 'maxLength': 160}, 'maxItems': 12}, 'skills': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 4}, 'headline': {'type': 'string'}, 'location': {'type': 'string'}, 'photoUrl': {'type': 'string', 'format': 'uri'}, 'username': {'type': 'string'}, 'workType': {'enum': ['local_service', 'professional'], 'type': 'string'}, 'languages': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 5}, 'priceLine': {'type': 'string', 'maxLength': 200}, 'updatedAt': {'type': 'string'}, 'workProof': {'type': 'object', 'required': ['proven', 'total'], 'properties': {'total': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, 'github': {'type': 'object', 'required': ['login', 'url', 'publicRepos', 'followers', 'stars', 'languages', 'lastPushAt', 'fetchedAt'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'login': {'type': 'string'}, 'stars': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'topics': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'repos'], 'properties': {'name': {'type': 'string'}, 'repos': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}}, 'fetchedAt': {'type': 'string'}, 'followers': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'languages': {'type': 'array', 'items': {'type': 'string'}}, 'lastPushAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'publicRepos': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'languageRepos': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'repos'], 'properties': {'name': {'type': 'string'}, 'repos': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'proven': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, 'website': {'type': 'object', 'required': ['url', 'host', 'verifiedAt'], 'properties': {'url': {'type': 'string'}, 'host': {'type': 'string'}, 'verifiedAt': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'profileUrl': {'type': 'string', 'format': 'uri'}, 'verifiedBy': {'type': 'array', 'items': {'enum': ['phone', 'github', 'google', 'licence'], 'type': 'string'}}, 'availability': {'enum': ['available', 'open_to_offers', 'not_looking', 'unspecified'], 'type': 'string'}, 'serviceAreas': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 5}, 'foundareeRole': {'enum': ['founder', 'team'], 'type': 'string'}, 'matchedSkills': {'type': 'array', 'items': {'type': 'string'}}, 'missingSkills': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
match_people
Match people to a requirement
Rank public Foundaree profiles against a list of required skills — use when the user describes a need ("a co-founder who knows React and has sold to enterprises", "a dentist in Pune", "someone to rewire my kitchen in Kochi") rather than searching for a known person. Give the required skills as `skills` (or describe the need in `q`; skill terms are then derived from it and `q` also narrows candidates by full text). location, area, workType, category, availability and lookingFor are hard filters; the skills only score: score = matched ÷ required (0–1), where a listed skill counts 1 and a term found in the person's category or lookingFor counts ½. Someone with 3 of 5 skills still appears, below someone with 5; ties break on availability (available first), then founding members (Foundaree's first 150 members), then recency. When nobody matches a single skill, the filtered candidates come back with score 0 and `fallback: true` instead of an empty list. Returns JSON with `items` (each: `person`, `score`, `matchedSkills`, `missingSkills`, `profileUrl`), `total`, `requiredSkills` and `fallback`. Each answer has two views: the text content is the JSON described above, and the structured content is a profile-card list (`people`, `total`, `query`). In apps that support MCP Apps (ChatGPT, Claude) the cards render as Foundaree profile cards. A person with `foundareeRole` ("founder" or "team") is part of Foundaree's own team; only Foundaree sets it.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Free-text description of the need, e.g. "someone with React and PostgreSQL experience". Used to derive skills when `skills` is absent, and as a full-text filter.'}, 'area': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Optional neighbourhood filter within the city (case-insensitive substring), e.g. "Kakkanad"'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of ranked results. Defaults to 20.'}, 'skills': {'type': 'array', 'items': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'maxItems': 50, 'description': 'The required skills, e.g. ["React", "PostgreSQL", "Kubernetes"]. Required unless q is given.'}, 'category': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'Optional comma-separated trade/profession filter (OR semantics), e.g. "driver" or "carpenter,electrician"'}, 'location': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Optional location filter (case-insensitive substring), e.g. "Bengaluru" or "Kochi"'}, 'workType': {'enum': ['local_service', 'professional'], 'type': 'string', 'description': 'Optional audience filter: local_service = blue-collar jobs, hands-on work (electricians, carpenters, drivers, cleaners, carers...); professional = white-collar jobs, office and professional work (developers, designers, accountants...)'}, 'lookingFor': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'Optional comma-separated looking-for filter (AND semantics), e.g. "cofounder" or "job,freelance"'}, 'availability': {'enum': ['available', 'open_to_offers', 'not_looking', 'unspecified'], 'type': 'string', 'description': 'Optional availability filter (exact match)'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['people', 'total', 'query'], 'properties': {'query': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'total': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'people': {'type': 'array', 'items': {'type': 'object', 'required': ['username', 'name', 'availability', 'workType', 'skills', 'profileUrl'], 'properties': {'area': {'type': 'string'}, 'name': {'type': 'string'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'trade': {'type': 'string'}, 'backed': {'type': 'array', 'items': {'type': 'string', 'maxLength': 160}, 'maxItems': 12}, 'skills': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 4}, 'headline': {'type': 'string'}, 'location': {'type': 'string'}, 'photoUrl': {'type': 'string', 'format': 'uri'}, 'username': {'type': 'string'}, 'workType': {'enum': ['local_service', 'professional'], 'type': 'string'}, 'languages': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 5}, 'priceLine': {'type': 'string', 'maxLength': 200}, 'updatedAt': {'type': 'string'}, 'workProof': {'type': 'object', 'required': ['proven', 'total'], 'properties': {'total': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, 'github': {'type': 'object', 'required': ['login', 'url', 'publicRepos', 'followers', 'stars', 'languages', 'lastPushAt', 'fetchedAt'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'login': {'type': 'string'}, 'stars': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'topics': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'repos'], 'properties': {'name': {'type': 'string'}, 'repos': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}}, 'fetchedAt': {'type': 'string'}, 'followers': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'languages': {'type': 'array', 'items': {'type': 'string'}}, 'lastPushAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'publicRepos': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'languageRepos': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'repos'], 'properties': {'name': {'type': 'string'}, 'repos': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'proven': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, 'website': {'type': 'object', 'required': ['url', 'host', 'verifiedAt'], 'properties': {'url': {'type': 'string'}, 'host': {'type': 'string'}, 'verifiedAt': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'profileUrl': {'type': 'string', 'format': 'uri'}, 'verifiedBy': {'type': 'array', 'items': {'enum': ['phone', 'github', 'google', 'licence'], 'type': 'string'}}, 'availability': {'enum': ['available', 'open_to_offers', 'not_looking', 'unspecified'], 'type': 'string'}, 'serviceAreas': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 5}, 'foundareeRole': {'enum': ['founder', 'team'], 'type': 'string'}, 'matchedSkills': {'type': 'array', 'items': {'type': 'string'}}, 'missingSkills': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
my_bookings
The user's own booking requests
List the booking requests people sent to the signed-in user: who asked, what they need, when, and whether it is still waiting for an answer. Use it when the user asks what is waiting on Foundaree, who wants to book them, or what they have not answered yet. Needs the user to have connected their Foundaree account. Lead with the ones still waiting, and offer to answer them with respond_to_booking.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
my_connection_requests
People waiting to connect with the user
List the connection requests waiting for the signed-in user, and the ones they sent that are still pending. Use it when the user asks who wants to connect, or what is waiting on Foundaree. Offer to answer them with respond_to_connection.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
request_appointment
Ask to book a person
Send a booking request to one person on Foundaree, for the user: "book this plumber for Saturday morning", "ask this dentist for an appointment". Use it only when the user asked to book or contact that person, and only with the user's OWN name and phone number, which they gave you: never guess or reuse another number. Before calling, tell the user what you will send and to whom, and get their yes. The person sees the request on Foundaree and by email, and calls the user back on that number if they can take it; nothing is confirmed until they do, so say that to the user. Find the username with search_people or match_people first. One open request per phone number and person; a few per number a day.
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'phone', 'need', 'when', 'username'], 'properties': {'area': {'type': 'string', 'description': "Where the work is: the user's area or address hint, e.g. 'Kakkanad, near Infopark'. Optional."}, 'name': {'type': 'string', 'description': "The user's own name, as they gave it."}, 'need': {'type': 'string', 'description': 'What the user needs done, in a sentence or two.'}, 'when': {'type': 'string', 'description': "When they would like it, in plain words, e.g. 'Saturday morning' or 'today after 5 pm'."}, 'phone': {'type': 'string', 'pattern': '^[0-9+\\s-]+$', 'maxLength': 20, 'description': "The user's own phone number, with country code when known, e.g. +91 98470 12345. The person calls back on it."}, 'username': {'type': 'string', 'maxLength': 48, 'minLength': 1, 'description': 'Username of the person to book, from search_people, match_people or get_person.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sent', 'message'], 'properties': {'sent': {'type': 'boolean', 'description': 'True when the request was stored for the person.'}, 'person': {'type': 'object', 'required': ['username', 'name', 'profileUrl'], 'properties': {'name': {'type': 'string'}, 'username': {'type': 'string'}, 'profileUrl': {'type': 'string'}}, 'additionalProperties': False}, 'message': {'type': 'string', 'description': 'What to tell the user.'}}, 'additionalProperties': False}
respond_to_booking
Accept or decline a booking request
Answer one booking request sent to the signed-in user. Get the id from my_bookings first. Always read the request back to the user and get a clear yes before calling this: it is their answer to a real person, not yours. Accepting does not arrange a time — the user still has to call them — so say that.
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['bookingId', 'answer'], 'properties': {'answer': {'enum': ['accept', 'decline'], 'type': 'string', 'description': 'What the user decided.'}, 'bookingId': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'The request id, from my_bookings.'}}}
respond_to_connection
Accept or decline a connection request
Answer one connection request sent to the signed-in user. Get the id from my_connection_requests first. Tell the user who it is and what they wrote, and get their yes before calling this. Declining removes the request quietly; the other person is not told they were declined.
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['requestId', 'answer'], 'properties': {'answer': {'enum': ['accept', 'decline'], 'type': 'string', 'description': 'What the user decided.'}, 'requestId': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'The request id, from my_connection_requests.'}}}
search_opportunities
Search jobs and openings
Search public openings on Foundaree: jobs, freelance work, internships, projects, co-founder and advisory roles. Use it when the user is looking for work or a role ("React jobs in Bengaluru", "a co-founder role in fintech", "internships in design"), or asks what a company is hiring for. Matches the title, description, city and skills. Only open listings are returned unless `includeClosed` is true. Returns JSON with `items` (each: `username`, `title`, `type`, `companyUsername`, `location`, `description`, `skills`, `status`, `listingUrl`, `companyUrl`) and `total`. People apply on the listing page on Foundaree; this tool does not apply for anyone. Foundaree is new, so there may be few or none: say so rather than guessing.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results. Defaults to 10.'}, 'query': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Role, skill, kind of work or city, e.g. "React developer Bengaluru"'}, 'includeClosed': {'type': 'boolean', 'default': False, 'description': 'Also return listings that are closed. Defaults to false.'}}}
search_organizations
Search companies
Search public company and organization pages on Foundaree by name, what they do, or city: "design studios in Kochi", "a clinic in Pune", "startups building for farmers". Use it when the user needs a company or team rather than one person. Returns JSON with `items` (each: `username`, `name`, `description`, `website`, `location`, `pageUrl`) and `total`. Foundaree is new, so there may be few or none: say so rather than guessing. A company's open roles come from search_opportunities.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results. Defaults to 10.'}, 'query': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Name, kind of company, what they do, or a city, e.g. "design studio Kochi"'}}}
search_people
Search people
Search public Foundaree profiles by free-text query and/or structured filters; give at least one. Free-text matches name, headline, bio, location, skills, experiences and projects. Each result carries `services` (what the person offers with prices), `languages`, `serviceAreas` (areas they cover) and `workingHours` (one entry per day, 24-hour HH:MM) when they gave them, so you can compare before booking. Each result has `updatedAt`, when the person last edited their profile: prefer recent ones when details matter, and say so when a profile is old. Among equally good matches, recently updated profiles rank a little higher. Structured filters: location (substring), area (neighbourhood substring; also matches the areas a person says they cover), language (a language they work in, e.g. Malayalam), workType (exact: local_service = blue-collar, hands-on work; professional = white-collar work), category (comma-separated trades/professions, OR semantics), availability (exact: available, open_to_offers, not_looking, unspecified), skills (comma-separated, AND semantics), lookingFor (comma-separated, AND semantics). Only the first 100 results can be paged through (offset + limit ≤ 100); add filters to narrow the search. Among people who fit equally well, founding members (Foundaree's first 150 members, `foundingMember`) come first; a better match always ranks higher. Returns JSON with a `results` array of structured people summaries. Results never include phone numbers or emails: use get_person for one profile's public contact details. Each answer has two views: the text content is the JSON described above, and the structured content is a profile-card list (`people`, `total`, `query`). In apps that support MCP Apps (ChatGPT, Claude) the cards render as Foundaree profile cards. A person with `foundareeRole` ("founder" or "team") is part of Foundaree's own team; only Foundaree sets it.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'area': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Optional neighbourhood filter within the city (case-insensitive substring), e.g. "Kakkanad"'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results. Defaults to 20.'}, 'query': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Optional free-text search query, e.g. "postgres engineer" or "technical co-founder"'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 99, 'minimum': 0, 'description': 'Pagination offset. Defaults to 0. Paging stops after the first 100 results.'}, 'skills': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'Optional comma-separated skills filter (AND semantics), e.g. "AI,ML" or "React,TypeScript"'}, 'category': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'Optional comma-separated trade/profession filter (OR semantics), e.g. "electrician" or "electrician,carpenter"'}, 'language': {'type': 'string', 'maxLength': 40, 'minLength': 1, 'description': 'Optional language they work in (whole name, any case), e.g. "Malayalam", "Tamil" or "Hindi"'}, 'location': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Optional location filter (case-insensitive substring), e.g. "Bangalore" or "San Francisco"'}, 'workType': {'enum': ['local_service', 'professional'], 'type': 'string', 'description': 'Optional audience filter: local_service = blue-collar jobs, hands-on work (electricians, carpenters, drivers, cleaners, carers...); professional = white-collar jobs, office and professional work (developers, designers, accountants...)'}, 'lookingFor': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'Optional comma-separated looking-for filter (AND semantics), e.g. "cofounder" or "job,freelance"'}, 'availability': {'enum': ['available', 'open_to_offers', 'not_looking', 'unspecified'], 'type': 'string', 'description': 'Optional availability filter (exact match)'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['people', 'total', 'query'], 'properties': {'query': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'total': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'people': {'type': 'array', 'items': {'type': 'object', 'required': ['username', 'name', 'availability', 'workType', 'skills', 'profileUrl'], 'properties': {'area': {'type': 'string'}, 'name': {'type': 'string'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'trade': {'type': 'string'}, 'backed': {'type': 'array', 'items': {'type': 'string', 'maxLength': 160}, 'maxItems': 12}, 'skills': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 4}, 'headline': {'type': 'string'}, 'location': {'type': 'string'}, 'photoUrl': {'type': 'string', 'format': 'uri'}, 'username': {'type': 'string'}, 'workType': {'enum': ['local_service', 'professional'], 'type': 'string'}, 'languages': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 5}, 'priceLine': {'type': 'string', 'maxLength': 200}, 'updatedAt': {'type': 'string'}, 'workProof': {'type': 'object', 'required': ['proven', 'total'], 'properties': {'total': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, 'github': {'type': 'object', 'required': ['login', 'url', 'publicRepos', 'followers', 'stars', 'languages', 'lastPushAt', 'fetchedAt'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'login': {'type': 'string'}, 'stars': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'topics': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'repos'], 'properties': {'name': {'type': 'string'}, 'repos': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}}, 'fetchedAt': {'type': 'string'}, 'followers': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'languages': {'type': 'array', 'items': {'type': 'string'}}, 'lastPushAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'publicRepos': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'languageRepos': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'repos'], 'properties': {'name': {'type': 'string'}, 'repos': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'proven': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, 'website': {'type': 'object', 'required': ['url', 'host', 'verifiedAt'], 'properties': {'url': {'type': 'string'}, 'host': {'type': 'string'}, 'verifiedAt': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'profileUrl': {'type': 'string', 'format': 'uri'}, 'verifiedBy': {'type': 'array', 'items': {'enum': ['phone', 'github', 'google', 'licence'], 'type': 'string'}}, 'availability': {'enum': ['available', 'open_to_offers', 'not_looking', 'unspecified'], 'type': 'string'}, 'serviceAreas': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 5}, 'foundareeRole': {'enum': ['founder', 'team'], 'type': 'string'}, 'matchedSkills': {'type': 'array', 'items': {'type': 'string'}}, 'missingSkills': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
set_my_availability
Set whether the user is free for work
Change the signed-in user's availability on their Foundaree profile: available (free for work now), open_to_offers (working, but will listen), or not_looking. This is public and it changes who finds them in search, so confirm with the user before calling it. Useful when they say they have finished a job, are fully booked, or want to be found again.
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['availability'], 'properties': {'availability': {'enum': ['available', 'open_to_offers', 'not_looking'], 'type': 'string', 'description': 'The state to set on the profile.'}}}
Modificado
get_person
28 de September de 2026 a las 02:41
Modificado
match_people
28 de September de 2026 a las 02:41
Modificado
search_people
28 de September de 2026 a las 02:41
Modificado
get_person
26 de September de 2026 a las 02:41
Modificado
match_people
26 de September de 2026 a las 02:41
Modificado
search_people
26 de September de 2026 a las 02:41
Modificado
find_and_ask
26 de September de 2026 a las 02:41
Modificado
get_person
24 de September de 2026 a las 02:40
Modificado
match_people
24 de September de 2026 a las 02:40
Modificado
search_people
24 de September de 2026 a las 02:40
Añadido
check_errand
24 de September de 2026 a las 02:40
Añadido
find_and_ask
24 de September de 2026 a las 02:40
Añadido
set_my_availability
24 de September de 2026 a las 02:40
Añadido
respond_to_connection
24 de September de 2026 a las 02:40
Añadido
my_connection_requests
24 de September de 2026 a las 02:40
Añadido
respond_to_booking
24 de September de 2026 a las 02:40
Añadido
my_bookings
24 de September de 2026 a las 02:40
Añadido
request_appointment
22 de September de 2026 a las 02:40
Añadido
search_opportunities
22 de September de 2026 a las 02:40
Añadido
search_organizations
22 de September de 2026 a las 02:40
Modificado
match_people
22 de September de 2026 a las 02:40
Modificado
search_people
22 de September de 2026 a las 02:40
Añadido
create_profile_draft
20 de September de 2026 a las 02:40
Añadido
get_person
20 de September de 2026 a las 02:40
Añadido
match_people
20 de September de 2026 a las 02:40
Añadido
search_people
20 de September de 2026 a las 02:40