> ## Documentation Index
> Fetch the complete documentation index at: https://docs.graphify.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> The PyPI package is graphifyy, with two y's. The command is graphify.
> /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.
> Choose the surface before you open a page. Local (Graphify Local) is the graphifyy package on the machine: the skill, the CLI, and the ten-tool MCP. Its pages are the Open Source tab (/open-source/) and the Graphify Local tab on each Integrations page. 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 Graphify (hosted) tab on each Integrations page. Prefer Graphify unless the user asks for a local or offline setup. Cookbooks (/cookbooks/) and /mcp/docs-search apply to both. Each page's source frontmatter records this as surface: local, cloud, or both. Buildkite is the CI integration.
> In llms.txt, tell the surface from the page path. Graphify: /platform/ and /concepts/. Local: /open-source/. Most /integrations/ pages cover both, with a Graphify (hosted) tab and a Graphify Local tab. Everything else applies to both.
> graphifyy release notes are published at https://github.com/Graphify-Labs/graphify/releases and https://graphify.com/changelog. The current package version is on PyPI (https://pypi.org/project/graphifyy/).
> The official site is https://graphify.com. These docs are https://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 JetBrains, ChatGPT, Codex, and Dots, and Vercel pages use the hosted server, not the ten-tool list. On pages with tabs, the Graphify (hosted) tab uses the hosted server and the Graphify Local tab uses the local skill or the ten-tool server.
> Read https://docs.graphify.com/llms.txt, then open one page's .md link. Use https://docs.graphify.com/llms-full.txt only when one page is not enough.

# MCP tool reference

> Reference for the ten tools in Graphify's local MCP server: the inputs for graph queries, paths, explanations, and pull request tools.

The current graph MCP server exposes ten tools. Connect it with the [MCP setup guide](https://docs.graphify.com/open-source/mcp-server.md).

Every tool also accepts an optional `project_path`: an absolute path to a project directory containing `graphify-out/graph.json`. Omit it to use the graph selected when the server started. Access is subject to the server’s path controls.

These schemas were extracted from the audited `graphify/serve.py` source. Graph exploration returns saved evidence. PR tools additionally use GitHub context; MCP triage returns data for your assistant to reason over.

## query\_graph

Search the knowledge graph using BFS or DFS. Returns relevant nodes and edges as text context.

| Input | Type | Required | Default / description |
| - | - | - | - |
| `question` | `string` | Yes | Natural language question or keyword search |
| `mode` | `string` | No | Default: `"bfs"`. bfs=broad context, dfs=trace a specific path Values: `bfs`, `dfs`. |
| `depth` | `integer` | No | Default: `3`. Traversal depth (1-6) |
| `token_budget` | `integer` | No | Default: `2000`. Max output tokens |
| `context_filter` | `array` | No | Optional explicit edge-context filter, e.g. \['call', 'field'] |

## get\_node

Get full details for a specific node by label or ID.

| Input | Type | Required | Default / description |
| - | - | - | - |
| `label` | `string` | Yes | Node label or ID to look up |

## get\_neighbors

Get all direct neighbors of a node with edge details.

| Input | Type | Required | Default / description |
| - | - | - | - |
| `label` | `string` | Yes | Optional. |
| `relation_filter` | `string` | No | Optional: filter by relation type |
| `token_budget` | `integer` | No | Default: `2000`. Max output tokens |

## get\_community

Get all nodes in a community by community ID.

| Input | Type | Required | Default / description |
| - | - | - | - |
| `community_id` | `integer` | Yes | Community ID (0-indexed by size) |
| `token_budget` | `integer` | No | Default: `2000`. Max output tokens |

## god\_nodes

Return the most connected nodes - the core abstractions of the knowledge graph.

| Input | Type | Required | Default / description |
| - | - | - | - |
| `top_n` | `integer` | No | Default: `10`. |
| `exclude_hubs_percentile` | `number` | No | Suppress nodes whose degree exceeds this percentile (0-100) of the degree distribution, matching cluster()'s hub exclusion |

## graph\_stats

Return summary statistics: node count, edge count, communities, confidence breakdown.

No required inputs. Call with `{}` for the default graph.

## shortest\_path

Find the shortest path between two concepts in the knowledge graph. Follows stored edge direction by default; set undirected=true to ignore it.

| Input | Type | Required | Default / description |
| - | - | - | - |
| `source` | `string` | Yes | Source concept label or keyword |
| `target` | `string` | Yes | Target concept label or keyword |
| `max_hops` | `integer` | No | Default: `8`. Maximum hops to consider |
| `undirected` | `boolean` | No | Default: `false`. Ignore stored edge direction when searching |

## list\_prs

List open GitHub PRs with CI status, review state, and graph impact (which communities each PR touches, blast radius). Use this before starting work to check if a PR already covers the area you're about to change.

| Input | Type | Required | Default / description |
| - | - | - | - |
| `base` | `string` | No | Base branch to filter PRs by (auto-detected if omitted) |
| `repo` | `string` | No | GitHub repo (owner/repo). Defaults to current repo. |

## get\_pr\_impact

Get detailed graph impact for a specific PR: which files it changes, which knowledge-graph communities are affected, and how many nodes are touched. Use this to assess merge risk or check for overlap with your current work.

| Input | Type | Required | Default / description |
| - | - | - | - |
| `pr_number` | `integer` | Yes | PR number to analyse |
| `repo` | `string` | No | GitHub repo (owner/repo). Defaults to current repo. |

## triage\_prs

Return all actionable open PRs (correct base, not stale) with full graph impact data so you can reason about review priority, merge order, and conflict risk. Call this when the user asks 'what PRs should I review?' or 'what's ready to merge?'

| Input | Type | Required | Default / description |
| - | - | - | - |
| `base` | `string` | No | Base branch to filter PRs by (auto-detected if omitted) |
| `repo` | `string` | No | GitHub repo (owner/repo). Defaults to current repo. |

## Example calls

```json query_graph theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
{"question": "request validation", "mode": "bfs", "token_budget": 1500}
```

```json shortest_path theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
{"source": "login", "target": "normalize_email", "max_hops": 8}
```

The second example uses the [tutorial project](https://docs.graphify.com/open-source/cli-quickstart.md). Replace labels with nodes from your graph. A returned path is source-level context, not proof of runtime execution.

## Next steps

> **[Try it in Graphify](https://docs.graphify.com/platform/quickstart.md)**
>
> We build and host the graph for you. Start with a 14-day Pro trial, then keep up to 3 repositories on Free. No card required.

> **[Connect your agent](https://docs.graphify.com/platform/connections.md)**
>
> Add the hosted MCP at `api.graphify.com/mcp`. Sign in with OAuth, no API key.

> **[Local MCP server](https://docs.graphify.com/open-source/mcp-server.md)**
>
> Serve a local graph to your assistant.

[PreviousConfiguration](https://docs.graphify.com/open-source/configuration/graphifyrc.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.