AI Tools Guide

Guidance to AI tools when working with ZK Compression. Includes MCP server, DeepWiki, and AI Search guides.

For Docs

• Docs AI Search - Search documentation with AI in the search bar.
• llms.txt - Site index for LLM navigation: https://zkcompression.com/llms.txt.
• Markdown Export - Append .md to any page URL for raw markdown.

For Development

MCP

The Model Context Protocol (MCP) is an open standard to connect AI apps to data sources and tools. The DeepWiki MCP server provides access to the Light Protocol repository with its search capabilities (AskDevin).

Installation

Claude Code

claude mcp add -s user -t http deepwiki https://mcp.deepwiki.com/mcp
claude mcp add -s user -t http zkcompression https://www.zkcompression.com/mcp

We recommend to create a command that includes the tools listed below.
Simply copy paste this snippet.

---
argument-hint: <question>
description: Query Light Protocol repository and Solana resources via DeepWiki MCP for precise technical answers and help with debugging
allowed-tools: mcp__deepwiki__*
---

# /ask-deepwiki

Answer: $ARGUMENTS

Use DeepWiki MCP to provide precise technical answers.

## Step 1: Identify Repository Scope

1. **State understanding and plan**

2. **If question is vague, ask for clarification:**
- What specific component or feature?
- What problem are you solving?
- What level of detail needed (overview vs implementation)?

3. **Repository mapping:**
- ZK Compression/Light Protocol: `Lightprotocol/light-protocol`
- Solana fundamentals: `solana-labs/solana`
- Anchor framework: `solana-foundation/anchor`
- Complex questions: Query multiple repositories

4. **Refine question to use:**
- Exact component names: `CompressedAccountMeta` not "account metadata"
- Specific operations: "verifies proof" not "handles proof"
- Concrete function names or error messages when available

## Step 2: Query DeepWiki

For the identified repository, call in sequence:

1. `mcp__deepwiki__read_wiki_structure("repo-owner/repo-name")`
2. `mcp__deepwiki__read_wiki_contents("repo-owner/repo-name")`
3. `mcp__deepwiki__ask_question("repo-owner/repo-name", refined_question)`

Query multiple repositories if question spans different systems.

## Step 3: Format Response

**Structure:**
1. Direct answer with technical explanation
2. Specific implementations and data structures
3. Code examples with inline comments
4. Source references (`file:line` from DeepWiki)
5. Related concepts if relevant

**Language precision:**

NEVER use vague verbs:
- "handles", "manages", "processes", "enables", "provides"

ALWAYS use exact names:
- Functions: `LightAccount::new_init()`, `derive_address()`
- Types: `CompressedAccountMeta`, `ValidityProof`, `PackedAddressTreeInfo`
- Operations: "nullifies hash", "appends to state tree", "verifies proof"
- Fields: `tree_info`, `address`, `output_state_tree_index`

Include `file:line` references from DeepWiki responses.

## Notes

- Always include source file references from DeepWiki responses
- Provide runnable code examples for implementation questions
- Ask follow-up questions to DeepWiki for clarification when needed

Codex

codex mcp add zkcompression -- npx -y mcp-remote@latest https://www.zkcompression.com/mcp
codex mcp add deepwiki -- npx -y mcp-remote@latest https://mcp.deepwiki.com/mcp

Most Clients (Windsurf, Cursor, ...)

{
  "mcpServers": {
    "deepwiki": {
      "serverUrl": "https://mcp.deepwiki.com/sse"
    },
    "zkcompression": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://www.zkcompression.com/mcp"]
    }
  }
}

DeepWiki MCP-Tools

• read_wiki_structure - Get a list of documentation topics for a GitHub repository

mcp__deepwiki__read_wiki_structure("Lightprotocol/light-protocol")

• read_wiki_contents - View documentation about a GitHub repository

mcp__deepwiki__read_wiki_contents("Lightprotocol/light-protocol")

• ask_question - Ask any question about the GitHub repository and get a context-grounded response

mcp__deepwiki__ask_question("Lightprotocol/light-protocol", "your question")

You can specify any public GitHub repo that is indexed with DeepWiki. When you connect to the MCP, you specify the repository when calling the tools. Learn more here.

Alternative: DeepWiki Web

If you don’t have the MCP installed we recommend to use AskDevin in your browser.