Skip to content
Back to search

sdl-mcp

Symbol Delta Ledger (SDL-MCP) is a policy-centered context budget layer for coding agents: Symbol-graph intelligence combined with precision tools. It turns sprawling codebases into compact, high-signal context that saves tokens, speeds up workflows, and improves agent output.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/glitterkill--sdl-mcp/badge.svg)](/listings/glitterkill--sdl-mcp)

HTML

<a href="/listings/glitterkill--sdl-mcp"><img src="/api/listings/glitterkill--sdl-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 146 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="./docs/readme-assets/readme-hero-v10.webp" alt="SDL-MCP context budget layer hero with themed logo, symbol graph lens, and feature callouts" width="100%">
  3. # Symbol Delta Ledger
  4. Cards-first code context for AI coding agents.
  5. [Get started](./docs/getting-started.md) · [Documentation](./docs/README.md) · [MCP tools](./docs/mcp-tools-reference.md) · [npm](https://www.npmjs.com/package/sdl-mcp)
  6. <br/>
  7. ![npm version](https://img.shields.io/npm/v/sdl-mcp.svg?style=for-the-badge)
  8. ![npm downloads](https://img.shields.io/npm/dm/sdl-mcp.svg?style=for-the-badge)
  9. ![GitHub commit activity](https://img.shields.io/github/commit-activity/w/GlitterKill/sdl-mcp?style=for-the-badge)<br/>
  10. [![RoastMyCode: A](https://roastmycode.ai/badge/GlitterKill/sdl-mcp)](https://roastmycode.ai/roast/latest/GlitterKill/sdl-mcp) [![CI](https://github.com/GlitterKill/sdl-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/GlitterKill/sdl-mcp/actions/workflows/ci.yml) ![Supported Node.js](https://img.shields.io/badge/node.js-%3E%3D24-green?link=https%3A%2F%2Fnodejs.org%2Fen)
  11. </div>
  12. ## Work from the symbols that matter
  13. SDL-MCP indexes a repository into a symbol graph and gives coding agents a controlled path from compact metadata to source code. Instead of starting with full files, an agent can search symbols, inspect cards, build a task-scoped slice, and request a bounded code window only when it needs one.
  14. The result is a smaller, more deliberate context surface for debugging, reviews, implementation work, and repository exploration. SDL-MCP runs locally and supports the Model Context Protocol over stdio or HTTP.
  15. <br />
  16. ## Start in a few minutes
  17. SDL-MCP requires Node.js 24 or later. For an interactive first install, run the wrapper package from the repository you want to index:
  18. ```bash
  19. npx create-sdl-mcp
  20. ```
  21. For a standard global install, initialize the repository, verify it, then start the stdio server:
  22. ```bash
  23. npm install -g sdl-mcp
  24. cd <repository>
  25. sdl-mcp init
  26. sdl-mcp doctor
  27. sdl-mcp serve --stdio
  28. ```
  29. Use `sdl-mcp init -y --auto-index` for non-interactive setup. The [Getting Started guide](./docs/getting-started.md) covers the setup wizard, supported clients, HTTP transport, and configuration examples.
  30. <br />
  31. ## A controlled retrieval loop
  32. 1. Index the repository into symbols, relationships, and compact metadata.
  33. 2. Start with symbol search, task-shaped context, or graph slicing.
  34. 3. Escalate through progressively richer views only when the task requires more detail.
  35. The Iris Gate Ladder makes the escalation explicit. Cards, skeletons, hot paths, and policy-gated source windows let an agent ask for the least code that can answer its question.
  36. <br />
  37. ## Choose the tool surface that fits the client
  38. The generated [tool inventory](./docs/generated/tool-inventory.md) is the source of truth for registered tools and mode counts.
  39. | Mode | Registered surface |
  40. | --- | --- |
  41. | Flat | 38 tools: 2 universal tools and 36 flat tools |
  42. | Gateway | 6 tools: 2 universal tools and 4 gateway namespaces |
  43. | Gateway with legacy | 42 tools: 2 universal, 4 gateway, and 36 flat tools |
  44. | Code Mode exclusive | 7 tools: `sdl.action.search`, `sdl.context`, `sdl.file`, `sdl.info`, `sdl.manual`, `sdl.retrieve`, and `sdl.workflow` |
  45. Code Mode provides a compact task-oriented surface. Gateway mode groups the regular actions into `sdl.agent`, `sdl.code`, `sdl.query`, and `sdl.repo`. The [MCP Tools Reference](./docs/mcp-tools-reference.md) explains requests and responses for the installed surface.
  46. <br />
  47. ## Build context from repository structure
  48. ### Symbol cards
  49. Each indexed symbol has a compact card with its identity, signature, summary, relationships, and other retrieval metadata. Cards give an agent a place to begin without opening a full source file.
  50. ### Graph slicing
  51. Graph slicing follows repository relationships rather than directory boundaries. Give SDL-MCP a task or a starting symbol and it returns a budgeted subgraph that can be refreshed or expanded through spillover.
  52. [Read about graph slicing](./docs/feature-deep-dives/graph-slicing.md) · [Read about task-shaped context](./docs/feature-deep-dives/agent-context.md)
  53. <br />
  54. ## Understand change and work against current code
  55. ### Delta packs and blast radius
  56. SDL-MCP can compare indexed versions, identify changed symbols, and trace affected relationships. `sdl.pr.risk.analyze` packages change evidence and test recommendations for pull-request review.
  57. ### Live indexing
  58. Draft-buffer updates can appear in a live overlay before the underlying file is saved. An accepted save then queues targeted reconciliation; configured SCIP, LSP, or parser preparation runs in the background and publishes only the latest saved generation. Retrieval continues from the committed graph and, when present, the overlay while that work prepares.
  59. [Read about delta packs](./docs/feature-deep-dives/delta-blast-radius.md) · [Read about live indexing](./docs/feature-deep-dives/live-indexing.md)
  60. <br />
  61. ## Use compiler and provider facts when they are available
  62. SDL-MCP uses tree-sitter for repository structure and can ingest SCIP and language-provider facts through provider-first indexing. This adds precise cross-references where a provider covers the file and falls back to the regular path for files it does not cover.
  63. [Read about SCIP integration](./docs/feature-deep-dives/scip-integration.md) · [Read about provider-first indexing](./docs/feature-deep-dives/provider-first-indexing.md)
  64. <br />
  65. ## Keep useful knowledge with the work
  66. Development memories are opt-in. When enabled, they store decisions and task notes with repository links so later work can retrieve them alongside the relevant context. Memory behavior and storage rules are documented in the [Memory Protocol](./docs/memory-protocol.md).
  67. <br />
  68. ## Keep tool registration compact
  69. Gateway mode reduces the visible regular action surface to four namespace tools while preserving server-side validation and routing. Use it when a client benefits from fewer tool choices; use the flat surface when direct tool names are more useful.
  70. [Read about the Tool Gateway](./docs/feature-deep-dives/tool-gateway.md) · [Read about Code Mode](./docs/feature-deep-dives/code-mode.md)
  71. <br />
  72. ## Operate the repository with guardrails
  73. Policy settings govern raw source windows. The runtime execution surface also applies configured executable, working-directory, environment, concurrency, and timeout controls. For HTTP deployments, SDL-MCP includes the graph viewer and observability dashboard.
  74. [Governance and policy](./docs/feature-deep-dives/governance-policy.md) · [Runtime execution](./docs/feature-deep-dives/runtime-execution.md) · [Graph viewer](./docs/feature-deep-dives/graph-viewer.md) · [Observability dashboard](./docs/feature-deep-dives/observability-dashboard.md)
  75. <br />
  76. ## Documentation map
  77. | If you need to... | Start here |
  78. | --- | --- |
  79. | Install, connect an agent, or choose a transport | [Getting Started](./docs/getting-started.md) |
  80. | Inspect the current MCP surface | [Generated Tool Inventory](./docs/generated/tool-inventory.md) and [MCP Tools Reference](./docs/mcp-tools-reference.md) |
  81. | Configure a repository | [Configuration Reference](./docs/configuration-reference.md) and [Configuration Examples](./docs/config-examples.md) |
  82. | Run CLI commands | [CLI Reference](./docs/cli-reference.md) |
  83. | Follow retrieval and editing workflows | [Agent Workflows](./docs/agent-workflows.md) |
  84. | Diagnose setup or runtime issues | [Troubleshooting](./docs/troubleshooting.md) |
  85. | Browse every public document | [Documentation Hub](./docs/README.md) |
  86. ## License
  87. SDL-MCP is source-available. The [Community License](./LICENSE) permits use, running, and modification, including internal business use. A [commercial license](./COMMERCIAL_LICENSE.md) is required before selling, licensing, sublicensing, bundling, embedding, or distributing SDL-MCP as part of a monetized product.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.