README
¶
Less noise. Better agents.
tap is one MCP server that stands in for all of yours. Your agent loads two tools,
plugin_search and plugin_call, instead of every tool from every server, and finds the rest
when it needs them.
Search or browse capabilities, inspect complete contracts, and call with validated arguments.
Saved tools are searched without starting their servers, even across sessions; a server starts
when one of its tools is called. With tap config set references on, large results can stay
behind session-local references rather than filling the agent's context.
Install
One binary; no Node runtime is needed. The script downloads the release for your machine and checks it against the release's checksums:
curl -fsSL https://raw.githubusercontent.com/fschrhunt/tap/main/install.sh | sh
With Homebrew:
brew tap fschrhunt/tap https://github.com/fschrhunt/tap
brew install fschrhunt/tap/tap
With Go 1.26 or newer:
go install github.com/fschrhunt/tap/cmd/tap@latest
Or build from source:
git clone https://github.com/fschrhunt/tap.git
cd tap
go build -o tap ./cmd/tap
Then point your agent at it, e.g. claude mcp add --scope user tap -- tap.
See Install for details.
Use
tap import # bring over the servers your agents have
tap add docs https://docs.example.com/mcp # or add an HTTP server
tap add files -- npx -y @modelcontextprotocol/server-filesystem ~/notes
tap auth linear # sign in to a server
tap list # servers and tool counts
tap search create issue # what your agent would find
tap --help lists every command, and tap COMMAND --help has examples for each.
Docs
Install · Servers · Command line · Settings · How it works · Remote
Benchmarks explain reproducible retrieval comparisons and measured task-run evaluation. No competitor superiority claim is made without matched end-to-end measurements.
License
MIT
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
bench
command
Command bench evaluates retrieval on a frozen corpus without servers or models.
|
Command bench evaluates retrieval on a frozen corpus without servers or models. |
|
tap
command
Command tap serves the MCP gateway or dispatches a one-shot CLI command.
|
Command tap serves the MCP gateway or dispatches a one-shot CLI command. |
|
internal
|
|
|
agents
Package agents reads the MCP servers that coding agents keep in their own config files and turns them into tap's server definitions.
|
Package agents reads the MCP servers that coding agents keep in their own config files and turns them into tap's server definitions. |
|
auth
Package auth signs tap in to MCP servers and keeps what the sign-in gives it.
|
Package auth signs tap in to MCP servers and keeps what the sign-in gives it. |
|
cli
Package cli is tap's command line.
|
Package cli is tap's command line. |
|
config
Package config reads and atomically edits tap's ordered server registry and its settings.
|
Package config reads and atomically edits tap's ordered server registry and its settings. |
|
discovery
Package discovery ranks MCP capabilities locally without network calls or models.
|
Package discovery ranks MCP capabilities locally without network calls or models. |
|
registry
Catalogs outlive sessions and retain the last successful list across failures.
|
Catalogs outlive sessions and retain the last successful list across failures. |
|
remote
Package remote hosts a shared registry and relays tap's static MCP surface.
|
Package remote hosts a shared registry and relays tap's static MCP surface. |
|
server
Package server exposes tap's two-tool MCP surface over stdio and HTTP.
|
Package server exposes tap's two-tool MCP surface over stdio and HTTP. |
|
wire
Package wire preserves JSON field order and JavaScript's printable JSON format at tap's CLI and MCP boundaries.
|
Package wire preserves JSON field order and JavaScript's printable JSON format at tap's CLI and MCP boundaries. |
|
test
|
|
|
fixture
command
Command fixture is an offline MCP peer with deterministic success, error, structured and hung responses.
|
Command fixture is an offline MCP peer with deterministic success, error, structured and hung responses. |