API Reference

This page is the current entrypoint for supported CodeGraph integration surfaces.

Supported Surfaces

Surface Use
REST API HTTP endpoints, authentication, project-scoped operations and service workflows.
MCP Tools Agent/tool integration through the governed MCP server.
gRPC API GoCPG runtime transport used by CodeGraph services.
WebSocket API Streaming dashboard and runtime interactions.
ACP Integration IDE integration through Agent Client Protocol.

Current Boundary

CodeGraph no longer documents raw DuckDB SQL execution as a supported external user API. Project-scoped runtime access must go through REST, MCP or the GoCPG gRPC transport. Python code that runs inside the API layer should use explicit ProjectContext / ProjectScopedServices boundaries rather than global active-project fallbacks.

Historical Python SDK and SQL examples are retained only under docs/reference/archive/ for traceability.