Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions agents/capabilities.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ icon: "map"

import { PromptBlock } from '/snippets/hero-install.jsx';

When your coding agent connects to the [hosted MCP server](/platform/hosted-mcp), it gets a set of Graphify tools. This page maps each job you might want done to the tool that does it, with a prompt you can paste. You don't have to name tools in your prompts. Naming them makes it easier to check that the agent used the graph.
When your coding agent connects to [Graphify MCP](/platform/graphify-mcp), it gets a set of Graphify tools. This page maps each job you might want done to the tool that does it, with a prompt you can paste. You don't have to name tools in your prompts. Naming them makes it easier to check that the agent used the graph.

## At a glance

Expand All @@ -27,6 +27,7 @@ When your coding agent connects to the [hosted MCP server](/platform/hosted-mcp)
| Find the tests linked to code | `graphify_tests_for` |
| Check that a repository is indexed, and how fresh it is | `graph_stats` |
| Read or save what the team remembers | `recall`, `memories_about`, `remember` |
| Read how a pull request review went | `review_status` |
| Switch between Graphify workspaces | `list_workspaces`, `set_workspace` |

## Find code
Expand Down Expand Up @@ -77,15 +78,15 @@ Most tools take a `repository_id`, either an id or a name like `acme/web-app`. `

- They don't edit your code or run your tests. Your agent does that with its own tools.
- They answer from the last index of your default branch. Code that isn't merged or indexed yet isn't in the results.
- There's no tool to read pull request reviews. Your agent reads reviews on GitHub. See [Know when a review is ready](/platform/reviews).
- `review_status` does not start a review. It reads status and results. A completed review has `gate` of `pass` or `advisory`, not a `passed` field. See [what review_status returns](/platform/graphify-mcp#what-review_status-returns).

## Related

<Columns cols={2}>
<Card title="Use Graphify from your agent" icon="list-checks" href="/agents/recipes">
Copy-ready prompts for common jobs.
</Card>
<Card title="Hosted MCP" icon="book" href="/platform/hosted-mcp">
<Card title="Graphify MCP" icon="book" href="/platform/graphify-mcp">
Client setup and limits.
</Card>
</Columns>
8 changes: 4 additions & 4 deletions agents/headless.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ The hosted MCP server at `https://api.graphify.com/mcp` uses OAuth. There is no
- Sign-in is a browser flow (authorization code with PKCE). A person has to finish it once in a browser.
- Graphify doesn't offer a device-code flow or a client-credentials flow. An agent can't sign itself in.
- After the first sign-in, the client keeps working on its own. It asks for `offline_access`, gets a refresh token, and refreshes when the access token expires.
- Each refresh rotates the refresh token. A client that reuses an old one has to sign in again. See [How hosted MCP sign-in works](/platform/hosted-mcp#how-hosted-mcp-sign-in-works).
- Each refresh rotates the refresh token. A client that reuses an old one has to sign in again. See [How sign-in works](/platform/graphify-mcp#how-sign-in-works).

If you're an agent and you hit `401`, don't loop. Tell the person which sign-in step to run, then stop. [Agents use Graphify](/agents/overview#while-sign-in-is-pending) lists what to do while you wait.

Expand All @@ -26,7 +26,7 @@ If you're an agent and you hit `401`, don't loop. Tell the person which sign-in
|---|---|---|
| Cursor cloud agents | Add `https://api.graphify.com/mcp` as a custom MCP server at [cursor.com/agents](https://cursor.com/agents). Cloud agents don't read a local or committed `mcp.json`. | The person, once, in the cursor.com sign-in prompt. |
| ChatGPT Dots and background tasks | Add the [Graphify plugin](/integrations/chatgpt). | The person, when they connect the plugin. While a Dot works in the background, connected apps stay read-only, so `remember` and `set_workspace` wait for approval. |
| Clients without remote OAuth | The [`mcp-remote` bridge](/platform/hosted-mcp#clients-without-remote-oauth) runs the sign-in and stores the credentials on that machine. | The person, once, on that machine. |
| Clients without remote OAuth | The [`mcp-remote` bridge](/platform/graphify-mcp#clients-without-remote-oauth) runs the sign-in and stores the credentials on that machine. | The person, once, on that machine. |

Full step-by-step setup for cloud agents: [Connect cloud coding agents](/cookbooks/cloud-coding-agents).

Expand All @@ -44,7 +44,7 @@ Use open-source Graphify instead. Your own infrastructure holds the graph, and y

## Limits to plan for

- 240 requests a minute per client IP and a 256 KB request body. Back off on `429`. See [Hosted MCP limits](/platform/hosted-mcp#hosted-mcp-limits).
- 240 requests a minute per client IP and a 256 KB request body. Back off on `429`. See [Graphify MCP limits](/platform/graphify-mcp#limits).
- `set_workspace` binds a session for 24 hours by default. A bot that runs longer should call `list_workspaces` to check which workspace is active.
- The graph reflects the last indexed snapshot of the default branch. See [Keep answers fresh](/agents/overview#keep-answers-fresh).

Expand All @@ -54,7 +54,7 @@ Use open-source Graphify instead. Your own infrastructure holds the graph, and y
<Card title="Agents use Graphify" icon="bot" href="/agents/overview">
Connect, pick the right tool, and handle sign-in.
</Card>
<Card title="Hosted MCP server" icon="server" href="/platform/hosted-mcp">
<Card title="Graphify MCP" icon="server" href="/platform/graphify-mcp">
Setup, sign-in, workspaces and limits.
</Card>
</Columns>
4 changes: 2 additions & 2 deletions agents/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ Rules for the results:
The tools don't edit source files, but two of them change stored state on purpose. Ask the user first:

- `remember` saves a note to the workspace's shared [Memory](/platform/memory). Save only what the user asked you to save.
- `set_workspace` changes which workspace, and so which repositories, the session reads. With `make_default`, it also changes the user's default. See [Hosted MCP](/platform/hosted-mcp#workspaces-and-mcp-sessions).
- `set_workspace` changes which workspace, and so which repositories, the session reads. With `make_default`, it also changes the user's default. See [Graphify MCP](/platform/graphify-mcp#workspaces-and-mcp-sessions).

In workspaces with trail capture turned on, `search`, `query_graph`, `graphify_find`, `graphify_trace`, `graphify_rank_files` and an unscoped `recall` can also save the question you asked to workspace memory. They never change source code.

Expand Down Expand Up @@ -96,7 +96,7 @@ If `list_repositories` succeeds but is empty, sign-in worked and no repository i
<Card title="Check your agent is using Graphify" icon="circle-check" href="/platform/verify-connection">
Test prompts and fixes per client.
</Card>
<Card title="Hosted MCP" icon="cloud" href="/platform/hosted-mcp">
<Card title="Graphify MCP" icon="cloud" href="/platform/graphify-mcp">
Sign-in, workspaces, limits and errors.
</Card>
<Card title="Make agents use the graph" icon="route" href="/cookbooks/make-agents-use-the-graph">
Expand Down
2 changes: 1 addition & 1 deletion agents/recipes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ icon: "list-checks"

import { PromptBlock } from '/snippets/hero-install.jsx';

Paste these prompts into any agent connected to Graphify. Each one names the tool it should trigger, so you can check that the agent used the graph instead of searching files one by one. Not connected yet? Use [Connect to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=graphify&config=eyJ1cmwiOiJodHRwczovL2FwaS5ncmFwaGlmeS5jb20vbWNwIn0%3D), the [Graphify extension for VS Code](https://marketplace.visualstudio.com/items?itemName=graphify-labs.graphify-mcp), the [Graphify plugin for ChatGPT and Codex](https://chatgpt.com/plugins/plugin_asdk_app_6abe89f7f5d88191b9422522bb8562a4), or the [hosted MCP setup](/platform/hosted-mcp).
Paste these prompts into any agent connected to Graphify. Each one names the tool it should trigger, so you can check that the agent used the graph instead of searching files one by one. Not connected yet? Use [Connect to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=graphify&config=eyJ1cmwiOiJodHRwczovL2FwaS5ncmFwaGlmeS5jb20vbWNwIn0%3D), the [Graphify extension for VS Code](https://marketplace.visualstudio.com/items?itemName=graphify-labs.graphify-mcp), the [Graphify plugin for ChatGPT and Codex](https://chatgpt.com/plugins/plugin_asdk_app_6abe89f7f5d88191b9422522bb8562a4), or [Graphify MCP](/platform/graphify-mcp).

Hosted Graphify lists 63 grammars. Open-source Graphify supports 40 languages (33 tree-sitter, 7 built-in).

Expand Down
2 changes: 1 addition & 1 deletion changelog/platform.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ icon: "cloud"
## Find Graphify with an MCP server card

### New
- **MCP:** Graphify now publishes an MCP Server Card at `https://api.graphify.com/mcp/server-card`, plus an AI Catalog that lists it. MCP apps and directories that read server cards can find Graphify and set it up before you connect. See [Hosted MCP](/platform/hosted-mcp#let-clients-find-graphify-with-a-server-card).
- **MCP:** Graphify now publishes an MCP Server Card at `https://api.graphify.com/mcp/server-card`, plus an AI Catalog that lists it. MCP apps and directories that read server cards can find Graphify and set it up before you connect. See [Graphify MCP](/platform/graphify-mcp#server-card-vs-the-mcp-connection).
</Update>

<Update label="2026-11-01" description="MCP sign-in works for more agents">
Expand Down
2 changes: 1 addition & 1 deletion cookbooks/agent-team-one-graph.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ A solo founder runs one product across three repositories: a web app, an API and
## Before you start

- Your repositories indexed in one [Graphify](https://app.graphify.com) workspace.
- The agents you use. Setup for each client is in [Hosted MCP](/platform/hosted-mcp).
- The agents you use. Setup for each client is in [Graphify MCP](/platform/graphify-mcp).

## Setup

Expand Down
4 changes: 2 additions & 2 deletions cookbooks/cross-repo-dependencies.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ Every agent on the team reads the same combined graph through one server. For Cl
claude mcp add --transport http --scope user graphify https://api.graphify.com/mcp
```

Start Claude Code, run `/mcp`, select **graphify**, and choose **Authenticate**. For Codex, Cursor, VS Code and other clients, see [Hosted MCP](/platform/hosted-mcp). If the `claude` command isn't available, as in the Claude desktop app, see [Claude Code](/integrations/claude-code).
Start Claude Code, run `/mcp`, select **graphify**, and choose **Authenticate**. For Codex, Cursor, VS Code and other clients, see [Graphify MCP](/platform/graphify-mcp). If the `claude` command isn't available, as in the Claude desktop app, see [Claude Code](/integrations/claude-code).

Check the agent can see the combined graph:

Expand Down Expand Up @@ -291,7 +291,7 @@ Your repositories now share one graph. Any agent on the team can ask what a chan
<Card title="Graph explorer" icon="book" href="/platform/graphs">
Combined graph limits, states and the impact view.
</Card>
<Card title="Hosted MCP" icon="utensils" href="/platform/hosted-mcp">
<Card title="Graphify MCP" icon="utensils" href="/platform/graphify-mcp">
Connect Codex, Cursor, VS Code and other agents.
</Card>
<TryCloudCard />
Expand Down
2 changes: 1 addition & 1 deletion cookbooks/document-the-why.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ import TryCloudCard from '/snippets/try-cloud-card.mdx';

## Before you start

- A repository indexed in [Graphify](https://app.graphify.com), with your coding agent connected to the [hosted MCP server](/platform/hosted-mcp). The open-source [Graphify CLI](/open-source/overview) works too.
- A repository indexed in [Graphify](https://app.graphify.com), with your coding agent connected to the [hosted MCP server](/platform/graphify-mcp). The open-source [Graphify CLI](/open-source/overview) works too.
- Access to your git history and issue tracker.

## Why AI coding agents "fix" code that isn't broken
Expand Down
4 changes: 2 additions & 2 deletions cookbooks/make-agents-use-the-graph.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,7 @@ Agents follow the instruction file they read at the start of every session: `CLA
session isn't in it yet, so read your own edits from disk.
```

To save the agent a lookup, you can set a default repository on the server URL instead, such as `https://api.graphify.com/mcp?repo=acme/web-app`. See [Hosted MCP](/platform/hosted-mcp).
To save the agent a lookup, you can set a default repository on the server URL instead, such as `https://api.graphify.com/mcp?repo=acme/web-app`. See [Graphify MCP](/platform/graphify-mcp).
</Tab>
<Tab title="Graphify CLI">
Let Graphify write the block for you. In the repository root:
Expand Down Expand Up @@ -327,7 +327,7 @@ Your agent now has a specific rule for when to call Graphify, a reminder at the
<Card title="Map dependencies across repositories" icon="utensils" href="/cookbooks/cross-repo-dependencies">
Combine repositories and ask what a change breaks.
</Card>
<Card title="Hosted MCP" icon="book" href="/platform/hosted-mcp">
<Card title="Graphify MCP" icon="book" href="/platform/graphify-mcp">
Every hosted tool, limits and client setup.
</Card>
<Card title="Give Claude Code a monorepo graph" icon="utensils" href="/cookbooks/claude-code-monorepo">
Expand Down
2 changes: 1 addition & 1 deletion cookbooks/read-your-graph.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -113,7 +113,7 @@ Open a finding and select **Copy task for my agent**. Use **Preview or edit the

The copied task tells your agent not to delete code, apply a change, open a pull request, or merge anything without your separate instruction. It asks the agent to return its investigation and a proposed next step first. Paste it into your agent, read what it finds, and only then approve the change.

For your agent to check callers against the graph while it works, connect it to the [hosted MCP server](/platform/hosted-mcp) and follow [Make your agent use the graph](/cookbooks/make-agents-use-the-graph).
For your agent to check callers against the graph while it works, connect it to the [hosted MCP server](/platform/graphify-mcp) and follow [Make your agent use the graph](/cookbooks/make-agents-use-the-graph).

## When it goes wrong

Expand Down
2 changes: 1 addition & 1 deletion cookbooks/reuse-existing-code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -112,7 +112,7 @@ Ask the agent at the end of the session which Graphify tools it called and what
<Card title="Make agents use the graph" icon="crosshair" href="/cookbooks/make-agents-use-the-graph">
Get agents to query Graphify before they grep.
</Card>
<Card title="Hosted MCP" icon="book" href="/platform/hosted-mcp">
<Card title="Graphify MCP" icon="book" href="/platform/graphify-mcp">
Every hosted tool and client setup.
</Card>
</Columns>
Expand Down
8 changes: 6 additions & 2 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@
"platform/overview",
"platform/how-it-works",
"platform/quickstart",
"platform/graphify-mcp",
"platform/verify-connection",
"concepts/index-a-repository",
"platform/keep-the-graph-fresh",
Expand Down Expand Up @@ -65,8 +66,7 @@
"platform/wiki",
"platform/memory",
"platform/learning",
"platform/connectors",
"platform/hosted-mcp"
"platform/connectors"
]
},
{
Expand Down Expand Up @@ -671,6 +671,10 @@
{
"source": "/platform/google-drive",
"destination": "/integrations/google-drive"
},
{
"source": "/platform/hosted-mcp",
"destination": "/platform/graphify-mcp"
}
]
}
4 changes: 2 additions & 2 deletions for-agents.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ This page holds the full rules. Every page's Markdown, [llms.txt](https://docs.g
## Which surface

- **Graphify CLI** is the open-source `graphifyy` package on the machine: the skill, the CLI, and the ten-tool MCP server. Its pages are the Graphify CLI tab (`/open-source/`) and the skill setup tabs in Integrations.
- **Graphify** is the hosted workspace and `https://api.graphify.com/mcp` (Streamable HTTP, OAuth, no API key). Its pages are the Graphify tab (`/platform/`, `/concepts/`) and the Hosted MCP and CI groups in Integrations.
- **Graphify** is the hosted workspace and `https://api.graphify.com/mcp` (Streamable HTTP, OAuth, no API key). Its pages are the Graphify tab (`/platform/`, `/concepts/`), including [Graphify MCP](/platform/graphify-mcp), and the coding-agent and CI pages in Integrations.
- Everything else, including Cookbooks (`/cookbooks/`), `/mcp/docs-search`, and `/platform/graphify-vs-local`, applies to both.
- Each page's source frontmatter records its surface as `surface: local`, `cloud`, or `both`.
- In llms.txt, tell the surface from the path: `/platform/` and `/concepts/` are Graphify, `/open-source/` is Graphify CLI. Most `/integrations/` pages cover both, with a Graphify tab and a Graphify CLI tab.
Expand Down Expand Up @@ -97,7 +97,7 @@ Default to Graphify, the hosted product. It needs no local build: the user signs

A new server loads only when a session starts. Tell the user to start a new Claude Code session, run `/mcp`, select **graphify**, and finish the sign-in in the browser. Run step 3 in that new session.

Other MCP clients: add a remote (Streamable HTTP) server at `https://api.graphify.com/mcp` and complete the browser sign-in. No API key is needed. See [Integrations](/integrations/overview) for every agent.
Other MCP clients: add a remote (Streamable HTTP) server at `https://api.graphify.com/mcp` and complete the browser sign-in. No API key is needed. See [Graphify MCP](/platform/graphify-mcp) for the endpoint, auth, and client setup, and [Integrations](/integrations/overview) for every agent.

3. Check the connection with this prompt:

Expand Down
2 changes: 1 addition & 1 deletion index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ import { HeroInstall, PromptBlock } from '/snippets/hero-install.jsx';
<div className="rounded-xl border border-[#d6e5dc] dark:border-[#262626] bg-[#ffffff] dark:bg-[#141515] p-6">
<div className="flex flex-wrap items-baseline justify-between gap-2"><h2 id="graphify-for-agents-title" className="m-0 text-xl font-medium tracking-[-0.02em]">Graphify for agents</h2><a href="/agents/overview" className="text-sm font-medium text-[#254d37] dark:text-[#d4d4d4] no-underline !border-b-0 hover:underline">How agents use Graphify →</a></div>
<ul className="m-0 mt-3 list-none divide-y divide-[#d6e5dc] dark:divide-[#262626] p-0">
<li className="grid gap-1 py-3 sm:grid-cols-[180px_1fr_auto] sm:items-center sm:gap-4"><span className="text-sm font-medium">Hosted MCP server</span><span className="text-sm leading-6 text-[#586b60] dark:text-[#a3a3a3]">Add https://api.graphify.com/mcp to any MCP client. Sign in with OAuth, no API key.</span><a href="/platform/hosted-mcp" className="text-sm font-medium text-[#118d4f] dark:text-[#4dea9c] no-underline !border-b-0 hover:underline">Hosted MCP →</a></li>
<li className="grid gap-1 py-3 sm:grid-cols-[180px_1fr_auto] sm:items-center sm:gap-4"><span className="text-sm font-medium">Graphify MCP</span><span className="text-sm leading-6 text-[#586b60] dark:text-[#a3a3a3]">Add https://api.graphify.com/mcp to any MCP client. Sign in with OAuth, no API key.</span><a href="/platform/graphify-mcp" className="text-sm font-medium text-[#118d4f] dark:text-[#4dea9c] no-underline !border-b-0 hover:underline">Graphify MCP →</a></li>
<li className="grid gap-1 py-3 sm:grid-cols-[180px_1fr_auto] sm:items-center sm:gap-4"><span className="text-sm font-medium">Plugins and one-click installs</span><span className="text-sm leading-6 text-[#586b60] dark:text-[#a3a3a3]">Install in Cursor, the VS Code extension, or the Graphify plugin for ChatGPT and Codex.</span><a href="/integrations/overview" className="text-sm font-medium text-[#118d4f] dark:text-[#4dea9c] no-underline !border-b-0 hover:underline">Integrations →</a></li>
<li className="grid gap-1 py-3 sm:grid-cols-[180px_1fr_auto] sm:items-center sm:gap-4"><span className="text-sm font-medium">Graphify CLI</span><span className="text-sm leading-6 text-[#586b60] dark:text-[#a3a3a3]">Run open-source Graphify on your machine and keep the graph in your own files.</span><a href="/open-source/cli-quickstart" className="text-sm font-medium text-[#118d4f] dark:text-[#4dea9c] no-underline !border-b-0 hover:underline">CLI quickstart →</a></li>
</ul>
Expand Down
Loading
Loading