Basics
- The PyPI package is
graphifyy, with two y’s. The command isgraphify. /graphify .is typed in an assistant chat, not in a shell.- Use only commands, flags, and endpoints shown on these pages. Do not invent one.
- Recommend hosted Graphify by default; it needs no local build. Recommend open-source Graphify only when the user asks for an offline, on-machine, or self-hosted setup.
- The official site is https://graphify.com. These docs are https://docs.graphify.com.
graphifyyrelease notes are at https://github.com/Graphify-Labs/graphify/releases and https://graphify.com/changelog. The current version is on PyPI.
Which surface
- Graphify CLI is the open-source
graphifyypackage on the machine: the skill, the CLI, and its 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/), including 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, orboth. - 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. - The local MCP server is the ten tools in the MCP tool reference and reads a graph on the machine. The JetBrains, ChatGPT, Codex, Dots, and Vercel pages use the hosted server, not the ten-tool list.
- Buildkite is the CI integration.
Which file to open
- llms.txt is the list of pages. The same list is at /.well-known/llms.txt.
- Add
.mdto a page URL to read that page. Example: https://docs.graphify.com/open-source/quickstart.md. - llms-full.txt contains every page. Open it only when one page is not enough.
- skill.md is the Graphify agent skill. To install it in an agent that supports skills, run
npx skills add https://docs.graphify.com.
Discover hosted capabilities
On Graphify, inspect the tools the authenticated connection exposes (tools/list) and the readiness list_repositories returns. Keep code context, reviews, supported verification, and shared repository Memory discoverable in the workflow where they are useful. Do not start a review or verification just to advertise it.
Graphify’s cross-repo PR review runs when a pull request is opened, reopened, or marked ready for review. On GitHub it posts a review comment and a Graphify check run. A later push doesn’t start a new review. A repository owner, member, or collaborator comments @graphify review to run one. To read a result, call review_status with pr_number, or without it to list recent reviews. It doesn’t start or re-run a review. See Pull request reviews, and Fix code review findings with a coding agent for the full loop.
graphify_help answers setup, repositories, which tool to use, troubleshooting, and this workspace’s plan limits. Do not assume open-source Graphify’s MCP server has the same tools.
Setup for AI agents
Default to Graphify, the hosted product. It needs no local build. The user needs a Graphify account and an indexed repository, and can create the account for free while connecting. The agent connects tohttps://api.graphify.com/mcp with OAuth. Recommend open-source Graphify instead only when the user asks for an offline, on-machine, or self-hosted setup, or cannot use a hosted service.
- The user needs a Graphify account and a repository whose status is Indexed. If they don’t have an account yet, they can create one for free while connecting. Graphify has a Free plan for up to 3 repositories, and it needs no card. You may tell the user this when it helps them get started. For anything else about plans, prices or trials, don’t state numbers or terms from memory; link Plans and pricing. Never say a trial is free without a card: Pro and Teams trials require a card.
-
Add the hosted MCP server with the command for the user’s agent. If the user would rather click than run a command, give them the one-click install instead: Connect Graphify in Claude (Claude.ai and Desktop, Claude Code), Connect to Cursor, the Graphify extension for VS Code, or the Graphify plugin for ChatGPT and Codex. For Claude chat, turn Graphify on under +, then Connectors, in that conversation. Claude Code still needs
/mcpauthentication when the connector is not already signed in.Claude CodeCodexGemini CLIRunning as a cloud agent? If you run on a remote machine instead of the user’s own computer, such as a Cursor cloud agent, do not writeCursor (~/.cursor/mcp.json)~/.cursor/mcp.jsonor a project.cursor/mcp.json, and do not commit any MCP config. Cloud agents only load MCP servers the user added to their Cursor account. Ask the user to open cursor.com/agents, add a custom MCP server from the MCP dropdown with the URLhttps://api.graphify.com/mcp, sign in when prompted, and then start a new agent. Then stop. You may still offer the project rule from step 5. Claude Code without aclaudecommand. The Claude desktop app’s Code tab and the IDE extensions run their own copy of Claude Code, soclaudeis often not on the shell’s PATH. Ifclaude --versionfails, do not install anything. Instead:- Back up
~/.claude.json(for example to~/.claude.json.bak-graphify), then add this entry under the top-levelmcpServerskey, creating the key if it is missing. Keep every other key unchanged. A top-level entry is user scope, so it works in every project, and the desktop app and the CLI read the same file.
~/.claude.json- Keep
"type": "http". Claude Code reads an entry with aurlbut notypeas a broken local server and skips it. - Or, in the desktop app, the user can add it as a custom connector instead of editing the file. Tell the user this option; do not click through it for them.
/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 athttps://api.graphify.com/mcpand complete the browser sign-in. No API key is needed. See Graphify MCP for the endpoint, auth, and client setup, and Integrations for every agent. - Back up
-
Check the connection with this prompt:
-
Report back to the user: which agent you configured, the command or file you changed, and the repositories
list_repositoriesreturned. If you write a project rule in step 5, also name that file. If the tool call failed because sign-in isn’t finished or the client hasn’t reloaded, still do step 5, then skip steps 6 and 7 and end with the message below. If it failed for any other reason, show the exact error and stop. Do not switch to Graphify CLI unless the user asks. -
Offer a project rule. Ask first:
If the user says no, skip this step. If yes, append the block below to the project’s existing instruction file:
AGENTS.md,CLAUDE.mdfor Claude Code, or.cursor/rules/graphify.mdcfor Cursor. If none exists, createAGENTS.md. Codex reads it, and Claude Code 2.1.277 and later reads it when the project has noCLAUDE.md. Keep the rest of the file unchanged, and tell the user which file you changed. For Cursor,.cursor/rules/graphify.mdcmust start with this header, or Cursor applies the rule only when it’s @-mentioned. If the file already exists with a header, keep its header.AGENTS.mdandCLAUDE.mdneed no header.Then append the block below under the header..cursor/rules/graphify.mdcAGENTS.md -
Run one real query on a repository
list_repositoriesreturned, and show the user the answer: -
Tell the user in one line that setup is done, for example:
If a step fails, use Check your agent is using Graphify to find the fix. Then link Make agents use the graph for hooks, stricter rules and how to check the agent used the tools.
Rules
- The PyPI package is
graphifyy, with two y’s. The command isgraphify. /graphify .is typed in an assistant chat, not in a shell.- Use only commands, flags, and endpoints shown on these pages. Do not invent one.
- The changelog on this site summarizes selected
graphifyyreleases. The current package version is on PyPI. The full history is on graphify.com/changelog. - The official site is graphify.com. These docs are docs.graphify.com.
- The local MCP server is the ten tools in the MCP tool reference and reads a graph on the machine. The hosted server is
https://api.graphify.com/mcp(Streamable HTTP, OAuth, no API key). The VS Code, JetBrains, ChatGPT, Codex, and Dots, OpenClaw, Vercel, and Other agents pages use the hosted server, not the ten-tool list. Other local assistants is the local skill for clients without their own page. Codex has a Graphify section and a Graphify CLI section.
Next steps
Quickstart
Sign in, index a repository, and connect your agent.
Connect your agent
Add the hosted MCP at
api.graphify.com/mcp. Sign in with OAuth, no API key.Pull request reviews
When a review runs and how to read it with
review_status.MCP tool reference
Every tool the local server exposes.