Get started / Overview
Gravity MCP
Connect your AI agent to Gravity. With Gravity's MCP server, an agent like Claude Code or Codex can read your groups and goals, show you who Gravity found for a goal, save goals for you, and start a new search when you ask.
What Gravity does#
Gravity helps members of small, trusted groups find people who could help with a goal, and the member who could introduce them. Each member's relationships stay private to them.
- A group is a circle of members who invited each other.
- A goal is an outcome you want help with. You choose which of your groups can read it.
- A match is a person Gravity found who may help with a goal. The path to them runs through your own Rolodex, or through a fellow member who knows them, called the connector.
A match is a possibility, not a commitment. It doesn't mean anyone has agreed to help, and Gravity never contacts the person. You and the connector decide whether to make an introduction, in Gravity.
What your agent can do#
| Task | Tools |
|---|---|
| Find your groups and see who's in them | list_groups, get_group_details |
| Read your goals and goals shared with your groups | list_goals, get_goal |
| See who Gravity found for your goal | get_goal_matches |
| Create, edit, share, or end a goal | save_goal |
| Start a new search | start_goal_matching |
Your agent can't look up a specific person, browse anyone's Rolodex, see contact details for people found through other members, or contact anyone. Introductions happen in Gravity, between people.
Server#
| URL | https://www.meetgravity.ai/api/mcp |
| Transport | Streamable HTTP |
| Sign-in | OAuth, with your Gravity account |
Get started#
- Connect your agent. It takes a couple of minutes.
- Learn how goals and audiences and matches and searches work.
- Follow a guide: find matches and search again, or create and edit a goal.
For agents#
Every page in these docs has a Markdown version at the same URL with .md added, such as /docs/mcp/quickstart.md. /llms.txt lists every page, and /llms-full.txt has all of them in one file.
Before acting for someone, read Privacy and safety for agents.