# 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`](/docs/mcp/tools/list_groups), [`get_group_details`](/docs/mcp/tools/get_group_details) |
| Read your goals and goals shared with your groups | [`list_goals`](/docs/mcp/tools/list_goals), [`get_goal`](/docs/mcp/tools/get_goal) |
| See who Gravity found for your goal | [`get_goal_matches`](/docs/mcp/tools/get_goal_matches) |
| Create, edit, share, or end a goal | [`save_goal`](/docs/mcp/tools/save_goal) |
| Start a new search | [`start_goal_matching`](/docs/mcp/tools/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

1. [Connect your agent](/docs/mcp/quickstart). It takes a couple of minutes.
2. Learn how [goals and audiences](/docs/mcp/concepts/goals) and [matches and searches](/docs/mcp/concepts/matches) work.
3. Follow a guide: [find matches and search again](/docs/mcp/guides/find-matches), or [create and edit a goal](/docs/mcp/guides/create-and-edit-goals).

## For agents

Every page in these docs has a Markdown version at the same URL with `.md` added, such as [`/docs/mcp/quickstart.md`](/docs/mcp/quickstart.md). [`/llms.txt`](/llms.txt) lists every page, and [`/llms-full.txt`](/llms-full.txt) has all of them in one file.

Before acting for someone, read [Privacy and safety for agents](/docs/mcp/privacy-and-safety).