structured-code-search-mcp

structured-code-search-mcp is a skill for Claude Code, Codex from yeaight7/agent-powerups. It costs 30 tokens per session (638 once invoked), scanned A, original, Apache-2.0.

A guide for using a code-search service that understands code structure, not just matching words. It can inspect syntax trees, symbols, and references across files.

In plain words
What is it for?
Use it to search code, query structural patterns, extract files or symbols, list symbols, and trace references within a bounded workspace.
Why use it?
It helps answer questions that ordinary text search cannot, such as where a function is used or which classes have a particular shape.

Skill for Claude CodeCodex

Part of the codebase-intelligence plugin — 4 skills, 1 command, 3 agents shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/yeaight7/agent-powerups/structured-code-search-mcp
Any agent
npx skills add yeaight7/agent-powerups --skill structured-code-search-mcp
Clone the repo
git clone --depth 1 https://github.com/yeaight7/agent-powerups

Made for: Claude Code, Codex.

Or install codebase-intelligence, the plugin that ships this one along with the rest of its 4 skills, 1 command, 3 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for structured-code-search-mcp

README.md
[![agentmods](https://agentmods.dev/badge/skills/yeaight7/agent-powerups/structured-code-search-mcp.svg)](https://agentmods.dev/skills/yeaight7/agent-powerups/structured-code-search-mcp)
Your own site
<a href="https://agentmods.dev/skills/yeaight7/agent-powerups/structured-code-search-mcp"><img src="https://agentmods.dev/badge/skills/yeaight7/agent-powerups/structured-code-search-mcp.svg" alt="Measured on agentmods" height="20"></a>
Per session 30 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 638 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00030 $0.00638
Opus 5 $0.00015 $0.00319
Sonnet 5 $0.00006 $0.00128
Haiku 4.5 $0.00003 $0.00064

Measured 4d ago against content hash 59c269a9cd65, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

structured-code-search-mcp scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/codebase-intelligence/skills/structured-code-search-mcp/SKILL.md · 66 lines

How it starts

The opening of the file, as written. The whole thing — 66 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Structured Code Search MCP

When to use

Use when an agent needs to search, navigate, or extract code using structural queries — AST patterns, symbol lookups, or cross-file reference tracing — beyond what simple grep or glob can provide, via an MCP-backed code search server.

Requirements / Checks

  • Prefer installed/pinned structured code search binaries over remote npx -y ...@latest execution.
  • Confirm the MCP client supports the required transport and method filtering.
  • Bound any search path to the current workspace unless the user explicitly approves otherwise.

Workflow

  1. Choose the right tool for the query:

    Need Tool
    Text/boolean search across files search_code
    Structural pattern (function shape, class with field) query_code
    Extract a specific file, range, or symbol extract_code
    List all symbols in target files symbols_code
  2. Bound scope before searching — set base path and default paths to the workspace. Set a result limit before running broad queries (e.g., max 20 results).

  3. Iterate from broad to narrow:

    • Start with search_code or symbols_code to identify candidate files.
    • Use query_code to narrow to the specific structural pattern.
    • Use extract_code to retrieve the exact code range needed.
  4. Filter methods at the server — use allowlists for read/search methods. Block write and edit methods by default; only enable if code modification is explicitly part of the task.

  5. Handle transport — support stdio or HTTP intentionally; set connect and tool call timeouts.

  6. Debug minimally — enable debug logs only long enough to capture connection, tool discovery, and failed calls. Disable after diagnosis.

Tool Interface (illustrative — actual names depend on your server)

  • search_code — text/boolean search with session dedup and result limits.
  • query_code — AST/structural search for code shapes.
  • extract_code — file/line/symbol extraction after search narrows scope.
  • symbols_code — symbol inventory for target files.

Read the full file on GitHub · 66 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 66 lines · 30 tokens per session scan A 59c269a9cd65

Subscribe to this mod's changes

structured-code-search-mcp is a skill published in the GitHub repository yeaight7/agent-powerups (6 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 30 tokens to every session and 638 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

mongodb-natural-language-querying

Generate read-only MongoDB queries (find) or aggregation pipelines using natural language, with collection schema context and sample documents. Use this skill whenever the user asks to write, create, or generate MongoDB queries, wants to filter/query/aggregate data in MongoDB, asks "how do I query...", needs help with…

mongodb/agent-skills · 162 tokens

plugin-publish

发布 Zhin.js 插件到 npm 和 Zhin 插件市场。Use when asked to publish a plugin, prepare for release, check publish readiness, or submit to the Zhin plugin marketplace. 引导完成发布前检查、版本管理和提交流程。.

zhinjs/zhin · 58 tokens

mongodb-schema-design

MongoDB schema design patterns and anti-patterns. Use when designing data models, reviewing schemas, migrating from SQL, or troubleshooting performance issues caused by schema problems. Triggers on "design schema", "embed vs reference", "MongoDB data model", "schema review", "unbounded arrays", "one-to-many", "tree…

mongodb/agent-skills · 127 tokens

plugin-develop

Implement Zhin.js plugin features with Plugin Runtime: defineCommand, defineAgentTool, middleware, pages. Use when asked to add a command, register a tool, wire cron, extend middleware, or build a console page. Triggers: 插件开发, add command, 加命令, 写插件功能, defineCommand.

zhinjs/zhin · 70 tokens

mongodb-query-optimizer

Help with MongoDB query optimization and indexing. Use only when the user asks for optimization or performance: "How do I optimize this query?", "How do I index this?", "Why is this query slow?", "Can you fix my slow queries?", "What are the slow queries on my cluster?", etc. Do not invoke for general MongoDB query…

mongodb/agent-skills · 98 tokens

short-drama

制作多集 AI 微短剧:建立剧集圣经和角色参考,完成分集剧本、逐镜 I2V、对白审计、配音字幕 BGM 与成片,保持跨镜跨集一致性。 当用户说“AI/横屏/竖屏/微短剧、拍短剧、分集剧本、连续剧情视频、做几集短剧”时使用。 单条非剧情视频用 auto-short-video;只写单条脚本用 video-script;只生成一个视频片段用 ai-video-gen。.

ZJU-REAL/Easel · 124 tokens