MCP ConfigsMay 12, 2026·2 min read

Semble — Code Search for Agents (MCP + CLI)

Semble is an agent-first code search CLI/MCP that returns only relevant chunks, using ~98% fewer tokens than grep+read and tracking savings locally.

MCP Hub
MCP Hub · Community
Agent ready

Safe staging for this asset

This asset is staged first. The copied prompt tells the agent to inspect the staged files and ask before activating scripts, MCP config, or global config.

Stage only · 17/100Policy: stage
Agent surface
Any MCP/CLI agent
Kind
Mcp Config
Install
Stage only
Trust
Trust: Established
Entrypoint
Asset
Safe staging command
npx -y tokrepo@latest install 19bb6bc0-1824-5ccc-8405-45c670801fd1 --target codex

Stages files first; activation requires review of the staged README and plan.

Intro

Semble is an agent-first code search CLI/MCP that returns only relevant chunks, using ~98% fewer tokens than grep+read and tracking savings locally.

  • Best for: agents and devs who need fast, token-light code discovery across large repos
  • Works with: Python; CLI + optional MCP integration; Claude Code/Codex/Cursor via shell or MCP client
  • Setup time: 5–15 minutes

Practical Notes

  • Quant: the README headline says it uses ~98% fewer tokens than grep+read on average.
  • Quant: the sample savings table shows ~58.4k tokens saved (95%) “Today” and ~1.2M tokens (89%) “All time”.

Main

Two reliable integration patterns:

  1. CLI-first: use semble search to get narrow chunks, then open full files only when needed.
  2. Agent workflows: copy the README’s “Code Search” snippet into AGENTS.md so agents consistently prefer Semble over full-file reads.

If you run Semble as MCP, keep your token budget stable: the agent should query Semble for candidates, then request full files only for the final few hits.

FAQ

Q: Do I need an API key or GPU? A: No—README describes CPU-only local runs with no external services required.

Q: How do I measure impact? A: Use semble savings and compare before/after over a week of real work.

Q: When does grep still matter? A: Exact string checks and exhaustive literal matches; Semble is for fast semantic discovery.

🙏

Source & Thanks

Source: https://github.com/MinishLab/semble > License: MIT > GitHub stars: 794 · forks: 61

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets

Exa MCP Server — Remote Search Tools for Agents

Exa MCP Server connects clients to Exa’s hosted web/code search tools via a remote MCP URL, with simple config for Cursor, VS Code, Claude Code, and Codex.

MCP Configs
MCP Hub

Claude Context — Semantic Code Search MCP

Claude Context is an MCP server for semantic code search, so agents can retrieve relevant code without stuffing whole folders into the prompt.

MCP Configs
MCP Hub

Firecrawl MCP — Web Search & Scrape Tools

Add Firecrawl MCP to your agent to search, scrape, and extract full-page content. Run via npx with an API key; fits Cursor, Claude Code, VS Code.

MCP Configs
MCP Hub

Linear MCP — Project Management for Claude Code & Cursor

Linear's official MCP lets Claude Code, Cursor, Codex CLI manage Linear issues, projects, cycles. Search by status, create issues from chat, link PRs.

MCP Configs
Linear
◈Home🔍Search👤Me