# Gravity

> Gravity helps members of small trusted groups find people who could help with their goals, and the member who could introduce them. Members connect their own AI agents to Gravity's MCP server at https://www.meetgravity.ai/api/mcp.

Each page below is Markdown. Its HTML version is the same URL without `.md`. [All pages in one file](https://www.meetgravity.ai/llms-full.txt).

## Get started

- [Overview](https://www.meetgravity.ai/docs/mcp.md): What Gravity's MCP server lets an agent do, and what it can't.
- [Quickstart](https://www.meetgravity.ai/docs/mcp/quickstart.md): Connect Claude Code, Codex, or another MCP client to Gravity.
- [Authentication](https://www.meetgravity.ai/docs/mcp/authentication.md): How OAuth sign-in, permissions, consent, tokens, and disconnecting work.

## Concepts

- [Goals and audiences](https://www.meetgravity.ai/docs/mcp/concepts/goals.md): Goal ownership, who reads a goal, private details, hidden groups, and versions.
- [Matches and searches](https://www.meetgravity.ai/docs/mcp/concepts/matches.md): What a match is, saved matches versus a new search, and following a search.

## Tools

- [Tools overview](https://www.meetgravity.ai/docs/mcp/tools.md): The seven tools, what each reads or changes, and the shared result format.
- [list_groups](https://www.meetgravity.ai/docs/mcp/tools/list_groups.md): List the groups you belong to.
- [get_group_details](https://www.meetgravity.ai/docs/mcp/tools/get_group_details.md): Read a group's roster and the goals shared with it.
- [list_goals](https://www.meetgravity.ai/docs/mcp/tools/list_goals.md): List your active goals, private ones included.
- [get_goal](https://www.meetgravity.ai/docs/mcp/tools/get_goal.md): Read one goal: its wording, versions, audience, and search state.
- [get_goal_matches](https://www.meetgravity.ai/docs/mcp/tools/get_goal_matches.md): Read the saved matches for one of your goals.
- [save_goal](https://www.meetgravity.ai/docs/mcp/tools/save_goal.md): Create a goal, or change or end one you own.
- [start_goal_matching](https://www.meetgravity.ai/docs/mcp/tools/start_goal_matching.md): Start a background search for one of your goals.

## Guides

- [Find matches and search again](https://www.meetgravity.ai/docs/mcp/guides/find-matches.md): Read a goal and its matches, then search networks that haven't been searched.
- [Create and edit a goal](https://www.meetgravity.ai/docs/mcp/guides/create-and-edit-goals.md): Create a goal with the right audience and private details, then edit it safely.

## Reference

- [Errors and limits](https://www.meetgravity.ai/docs/mcp/errors-and-limits.md): Errors, retries, request IDs, and limits for every tool.
- [Privacy and safety for agents](https://www.meetgravity.ai/docs/mcp/privacy-and-safety.md): Rules an agent follows when acting for a Gravity member.