API reference

The tools the Graphite Atlas MCP server gives your AI, as of @graphite-atlas/mcp-server 1.8.0 and the hosted server at https://graphiteatlas.com/api/mcp. Ask your AI to call server_info to see which version it is connected to.

Atlases

Tool	Description
`list_atlases`	List the atlases in your account
`search_atlases`	Find atlases by name or description
`get_atlas`	Get one atlas by ID
`create_atlas`	Create a new atlas
`update_atlas`	Update an atlas's name or description
`delete_atlas`	Permanently delete an atlas
`get_atlas_brief`	A context brief: business summary, key points, query patterns and suggested questions
`generate_setup`	Generate `CLAUDE.md` content for an atlas: tool setup plus its context brief

Points

Tool	Description
`list_points`	An index of points (ID, name, type), one page at a time
`get_point`	Get one point by ID (its paths are not included)
`create_point`	Create a point with name, type and properties
`update_point`	Update a point's name, type, description or properties
`delete_point`	Delete a point
`search_points`	Find points by name or type
`semantic_search`	Find points by meaning rather than exact text
`bulk_update_points`	Update many points in one call
`bulk_delete_points`	Delete many points in one call

See the Type glossary for valid point types.

Paths

Tool	Description
`list_paths`	An index of paths with source and target names, one page at a time
`get_path`	Get one path by ID
`create_path`	Create a path between two points
`update_path`	Update a path's type, description or properties
`delete_path`	Delete a path
`search_paths`	Find paths by name or type
`bulk_update_paths`	Update many paths in one call
`bulk_delete_paths`	Delete many paths in one call

See the Type glossary for valid path types.

Batch

Tool	Description
`batch_create`	Create many points and paths in one atomic operation
`brain_dump`	Extract points and paths from free text with AI (deprecated)

batch_create accepts point names (not IDs) for path source and target.

Views and folders

Tool	Description
`list_views`	List the views in an atlas
`get_view`	Get one view and its settings
`create_view`	Create a view, optionally inside a folder
`update_view`	Update a view's name, description, type or layout
`delete_view`	Delete a view (not the default view)
`get_view_points`	Get the points in a view
`add_points_to_view`	Add points to a view (also how you show a hidden point)
`remove_points_from_view`	Remove points from a view (also how you hide them)
`remove_point_from_view`	Deprecated: use `remove_points_from_view`
`get_view_hierarchy`	Get the folder and view tree
`create_folder`	Create a folder
`move_view_to_folder`	Move a view into a folder
`update_view_hierarchy`	Reorder or nest views and folders

Files

Tool	Description
`list_files`	List an atlas's files, their status and the points they are attached to
`attach_file_to_point`	Store a file and attach it to a point

Comments

Tool	Description
`list_comments`	List open comment threads addressed to Navigator
`reply_to_comment`	Reply in a comment thread
`resolve_comment`	Mark a comment thread done

Validation and ontology

Tool	Description
`validate_points`	Check point types against the ontology
`validate_paths`	Check path types against the ontology
`find_similar_points`	Find existing points similar to a proposed one, to avoid duplicates
`lookup_ontology`	Browse valid types, categories and path constraints

lookup_ontology has four query modes:

point_types: list all valid point types
path_types: list all valid path types
paths_for_type: the valid paths for one point type
search: search type names and descriptions

Graph analysis

Tool	Description
`rank_points`	Rank points by PageRank, betweenness or degree
`find_communities`	Groups of points more connected to each other than to the rest
`find_components`	The separate islands of an atlas
`find_similar_structure`	Points connected like a given point
`shortest_path`	The fewest-hops route between two points
`traverse`	Every point within a number of hops of one point
`run_audit`	Check an atlas for structural problems
`get_page_rank`	Rank points by influence
`get_betweenness_centrality`	Find bridge points between parts of the atlas
`get_node_neighborhood`	A point's connections within N hops
`find_isolated_nodes`	Points with no paths

History

Tool	Description
`get_history`	An atlas's change history, newest first: who changed what, and when

AtlasQL

Tool	Description
`describe_schema`	The tables, columns, allowed functions and limits, plus the point types, path types and property keys in use in this atlas
`query_atlas`	Run one read-only SQL `SELECT` against your atlas

AtlasQL answers counting, filtering and multi-hop questions in plain SQL. Call describe_schema first, then write the query.

Tables: points, paths, views, view_points, folders, citations, point_types and path_types. Every table is already scoped to the atlas.
Joins: join paths.source_id or paths.target_id to points.id. A path's relationship is paths.type.
Values: pass them as $1, $2 in params, never inside the query text.
Limits: at most 1,000 rows come back. truncated tells you there were more.
Dry run: compile_only returns the compiled SQL without running it.
Read only: AtlasQL refuses writes and anything outside its tables.

Count points by type:

select type, count(*) as points from points group by type order by points desc

Find who performs the most steps, with params set to ["performs"]:

select performer.name as performer, count(*) as steps
from paths
join points performer on performer.id = paths.source_id
join points step on step.id = paths.target_id
where paths.type = $1
group by performer.name
order by steps desc
limit 5

For ranking, communities, islands and routes, use the graph analysis tools.

Server

Tool	Description
`server_info`	Server version and capabilities

Atlases​

Points​

Paths​

Batch​

Views and folders​

Files​

Comments​

Validation and ontology​

Graph analysis​

History​

AtlasQL​

Server​

Need help?​