Agentsbestfriend
Gives AI coding agents a SQLite-backed index of your codebase with 20+ tools for token-efficient navigation. Exposes ripgrep search, AST-based symbol extraction, import graphs, impact analysis, and TypeScript language service queries (definitions, hover, diagnostics). Optionally generates file summaries and embeddings via Ollama for semantic search. Includes write-protected refactoring tools (preview changes, generate edit plans) plus an atomic file writer behind an environment flag. The CLI handles indexing, file watching, and agent installation for Cursor, VS Code Copilot, Claude Desktop, and others. Useful when your agent is burning tokens re-reading files or doing blind searches across large projects.
- tools
- 22
- transport
- STDIO
- env var
- 1
- last updated
- Apr 9, 2026
Tools
22 toolsPublic tool metadata for what this MCP can expose to an agent.
abf_searchCode search — exact (ripgrep), keyword-ranked, or semantic (embedding-based)
Code search — exact (ripgrep), keyword-ranked, or semantic (embedding-based)
No parameter schema in public metadata yet.
abf_search_multiRun multiple search queries (exact/keyword/semantic) in one call with weighted score merging
Run multiple search queries (exact/keyword/semantic) in one call with weighted score merging
No parameter schema in public metadata yet.
abf_symbolsFunctions, classes, exports in a file (AST-based for TS/JS, regex for Python)
Functions, classes, exports in a file (AST-based for TS/JS, regex for Python)
No parameter schema in public metadata yet.
abf_chunkSmart file chunk by symbol name, chunk index, or file overview
Smart file chunk by symbol name, chunk index, or file overview
No parameter schema in public metadata yet.
abf_project_overviewTech stack, folder structure, key dependencies at a glance
Tech stack, folder structure, key dependencies at a glance
No parameter schema in public metadata yet.
abf_dependenciesImport graph — who imports what
Import graph — who imports what
No parameter schema in public metadata yet.
abf_impactFind all usages of a symbol across the project
Find all usages of a symbol across the project
No parameter schema in public metadata yet.
abf_impact_typedAST-aware (ts-morph) impact analysis with classified references (definition/call/import/type_ref/jsx) and confidence levels
AST-aware (ts-morph) impact analysis with classified references (definition/call/import/type_ref/jsx) and confidence levels
No parameter schema in public metadata yet.
abf_blast_radiusBFS over reverse-import graph for a file with risk scoring (low/medium/high)
BFS over reverse-import graph for a file with risk scoring (low/medium/high)
No parameter schema in public metadata yet.
abf_related_testsHeuristically rank test files most likely to cover a file or symbol
Heuristically rank test files most likely to cover a file or symbol
No parameter schema in public metadata yet.
abf_preview_changesRead-only preview: diff + symbol/import deltas + risk flags + external usage probe (no writes)
Read-only preview: diff + symbol/import deltas + risk flags + external usage probe (no writes)
No parameter schema in public metadata yet.
abf_refactor_planRead-only ordered edit plan for rename/move/extract/split with collision detection
Read-only ordered edit plan for rename/move/extract/split with collision detection
No parameter schema in public metadata yet.
abf_apply_editWrite tool — atomic file write with sha256 hash check (disabled unless ABF_ENABLE_WRITES=1)
Write tool — atomic file write with sha256 hash check (disabled unless ABF_ENABLE_WRITES=1)
No parameter schema in public metadata yet.
abf_diagnosticsTypeScript diagnostics (errors/warnings) for one file or all tracked TS/JS files
TypeScript diagnostics (errors/warnings) for one file or all tracked TS/JS files
No parameter schema in public metadata yet.
abf_definitionGoto-definition via the TypeScript language service — file, line range, and source preview
Goto-definition via the TypeScript language service — file, line range, and source preview
No parameter schema in public metadata yet.
abf_hoverType signature + JSDoc for an identifier (IDE-style hover)
Type signature + JSDoc for an identifier (IDE-style hover)
No parameter schema in public metadata yet.
abf_call_graphTransitive callers/callees of a function or method (TS/JS, ts-morph)
Transitive callers/callees of a function or method (TS/JS, ts-morph)
No parameter schema in public metadata yet.
abf_gitGit log, blame, diff (recent/staged/unstaged)
Git log, blame, diff (recent/staged/unstaged)
No parameter schema in public metadata yet.
abf_file_summaryFull-text search across LLM-generated file summaries (FTS5, OR/AND mode)
Full-text search across LLM-generated file summaries (FTS5, OR/AND mode)
No parameter schema in public metadata yet.
abf_conventionsDetected naming, structure, and formatting conventions
Detected naming, structure, and formatting conventions
No parameter schema in public metadata yet.
abf_indexIndex status, rebuild, incremental update, or trigger re-summarization
Index status, rebuild, incremental update, or trigger re-summarization
No parameter schema in public metadata yet.
abf_pingHealth check — returns version and project root
Health check — returns version and project root
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
ABF_PROJECT_ROOTThe root directory of the project that the server will interact with. Defaults to the current working directory if not set.
Readme
AgentsBestFriend (abf)
Give your AI coding agents superpowers — a local MCP server for fast, token-efficient code navigation, search & analysis.
Works with VS Code Copilot, Cursor, Claude Code/Desktop, Codex, Cline, Zed, Gemini CLI, Goose, OpenCode, and any other MCP-compatible agent.
Why?
AI coding agents waste tokens re-reading files and searching blindly. ABF gives them purpose-built tools that return exactly what they need — in compact, structured responses that preserve context.
Tools
Details
- Repository
- github.com/therealfloatdev/agentsbestfriend
- Package
agentsbestfriend- Transport
- STDIO
- Registry
- MCP registry, active