MCP¶
agentgrep’s MCP server exposes a read-only search surface over stdio.
Search opens fast prompt-history stores by default. Set
effort="targeted" to search a bounded set of conversations selected
from prompt evidence, or effort="exhaustive" to search every readable
conversation. scope separately controls returned record kinds. The
server does not mutate local agent stores, open SQLite in write mode, or
execute arbitrary shell commands.
With targeted or exhaustive effort and omitted scope, MCP infers
scope="all". It does not broaden an explicit prompt scope: targeted effort
with scope="prompts" is rejected. Search is cursorless and keeps its
omitted-result-limit default of 20.
Install¶
Pick a client, install method, and config scope. The snippet copies directly into your terminal or config file.
With uvx installed:
$ claude mcp add agentgrep -- uvx --from agentgrep agentgrep-mcp
Config file: ~/.claude.json (this project)
With uvx installed:
$ claude mcp add agentgrep -- uvx --exclude-newer P7D --exclude-newer-package agentgrep=2099-01-01 --from agentgrep agentgrep-mcp
Config file: ~/.claude.json (this project)
With uvx installed:
$ claude mcp add agentgrep -- uvx --no-config --from agentgrep agentgrep-mcp
Config file: ~/.claude.json (this project)
With uvx installed:
$ claude mcp add agentgrep --scope user -- uvx --from agentgrep agentgrep-mcp
Config file: ~/.claude.json (all projects)
With uvx installed:
$ claude mcp add agentgrep --scope user -- uvx --exclude-newer P7D --exclude-newer-package agentgrep=2099-01-01 --from agentgrep agentgrep-mcp
Config file: ~/.claude.json (all projects)
With uvx installed:
$ claude mcp add agentgrep --scope user -- uvx --no-config --from agentgrep agentgrep-mcp
Config file: ~/.claude.json (all projects)
With uvx installed:
$ claude mcp add agentgrep --scope project -- uvx --from agentgrep agentgrep-mcp
Config file: .mcp.json (in repo, version-controlled)
With uvx installed:
$ claude mcp add agentgrep --scope project -- uvx --exclude-newer P7D --exclude-newer-package agentgrep=2099-01-01 --from agentgrep agentgrep-mcp
Config file: .mcp.json (in repo, version-controlled)
With uvx installed:
$ claude mcp add agentgrep --scope project -- uvx --no-config --from agentgrep agentgrep-mcp
Config file: .mcp.json (in repo, version-controlled)
With pipx installed:
$ claude mcp add agentgrep -- pipx run --spec agentgrep agentgrep-mcp
Config file: ~/.claude.json (this project)
With pipx installed:
$ claude mcp add agentgrep -- pipx run --spec agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.claude.json (this project)
With pipx installed:
$ claude mcp add agentgrep -- pipx run --spec agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.claude.json (this project)
With pipx installed:
$ claude mcp add agentgrep --scope user -- pipx run --spec agentgrep agentgrep-mcp
Config file: ~/.claude.json (all projects)
With pipx installed:
$ claude mcp add agentgrep --scope user -- pipx run --spec agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.claude.json (all projects)
With pipx installed:
$ claude mcp add agentgrep --scope user -- pipx run --spec agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.claude.json (all projects)
With pipx installed:
$ claude mcp add agentgrep --scope project -- pipx run --spec agentgrep agentgrep-mcp
Config file: .mcp.json (in repo, version-controlled)
With pipx installed:
$ claude mcp add agentgrep --scope project -- pipx run --spec agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: .mcp.json (in repo, version-controlled)
With pipx installed:
$ claude mcp add agentgrep --scope project -- pipx run --spec agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: .mcp.json (in repo, version-controlled)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ claude mcp add agentgrep -- agentgrep-mcp
Config file: ~/.claude.json (this project)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ claude mcp add agentgrep -- agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.claude.json (this project)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ claude mcp add agentgrep -- agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.claude.json (this project)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ claude mcp add agentgrep --scope user -- agentgrep-mcp
Config file: ~/.claude.json (all projects)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ claude mcp add agentgrep --scope user -- agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.claude.json (all projects)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ claude mcp add agentgrep --scope user -- agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.claude.json (all projects)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ claude mcp add agentgrep --scope project -- agentgrep-mcp
Config file: .mcp.json (in repo, version-controlled)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ claude mcp add agentgrep --scope project -- agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: .mcp.json (in repo, version-controlled)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ claude mcp add agentgrep --scope project -- agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: .mcp.json (in repo, version-controlled)
With uvx installed:
{
"mcpServers": {
"agentgrep": {
"command": "uvx",
"args": ["--from", "agentgrep", "agentgrep-mcp"]
}
}
}
Config file: claude_desktop_config.json
With uvx installed:
{
"mcpServers": {
"agentgrep": {
"command": "uvx",
"args": ["--exclude-newer", "P7D", "--exclude-newer-package", "agentgrep=2099-01-01", "--from", "agentgrep", "agentgrep-mcp"]
}
}
}
Config file: claude_desktop_config.json
With uvx installed:
{
"mcpServers": {
"agentgrep": {
"command": "uvx",
"args": ["--from", "agentgrep", "agentgrep-mcp"],
"env": { "UV_NO_CONFIG": "1" }
}
}
}
Config file: claude_desktop_config.json
With pipx installed:
{
"mcpServers": {
"agentgrep": {
"command": "pipx",
"args": ["run", "--spec", "agentgrep", "agentgrep-mcp"]
}
}
}
Config file: claude_desktop_config.json
With pipx installed:
{
"mcpServers": {
"agentgrep": {
"command": "pipx",
"args": ["run", "--spec", "agentgrep", "agentgrep-mcp"]
}
}
}
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: claude_desktop_config.json
With pipx installed:
{
"mcpServers": {
"agentgrep": {
"command": "pipx",
"args": ["run", "--spec", "agentgrep", "agentgrep-mcp"]
}
}
}
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: claude_desktop_config.json
Install the packages first:
$ pip install --user --upgrade agentgrep
Then use this config:
{
"mcpServers": {
"agentgrep": {
"command": "agentgrep-mcp"
}
}
}
Config file: claude_desktop_config.json
Install the packages first:
$ pip install --user --upgrade agentgrep
Then use this config:
{
"mcpServers": {
"agentgrep": {
"command": "agentgrep-mcp"
}
}
}
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: claude_desktop_config.json
Install the packages first:
$ pip install --user --upgrade agentgrep
Then use this config:
{
"mcpServers": {
"agentgrep": {
"command": "agentgrep-mcp"
}
}
}
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: claude_desktop_config.json
With uvx installed:
$ codex mcp add agentgrep -- uvx --from agentgrep agentgrep-mcp
Config file: ~/.codex/config.toml
With uvx installed:
$ codex mcp add agentgrep -- uvx --exclude-newer P7D --exclude-newer-package agentgrep=2099-01-01 --from agentgrep agentgrep-mcp
Config file: ~/.codex/config.toml
With uvx installed:
$ codex mcp add agentgrep -- uvx --no-config --from agentgrep agentgrep-mcp
Config file: ~/.codex/config.toml
With uvx installed:
Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.
[mcp_servers.agentgrep]
command = "uvx"
args = ["--from", "agentgrep", "agentgrep-mcp"]
Config file: .codex/config.toml (in repo)
With uvx installed:
Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.
[mcp_servers.agentgrep]
command = "uvx"
args = ["--exclude-newer", "P7D", "--exclude-newer-package", "agentgrep=2099-01-01", "--from", "agentgrep", "agentgrep-mcp"]
Config file: .codex/config.toml (in repo)
With uvx installed:
Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.
[mcp_servers.agentgrep]
command = "uvx"
args = ["--from", "agentgrep", "agentgrep-mcp"]
env = { UV_NO_CONFIG = "1" }
Config file: .codex/config.toml (in repo)
With pipx installed:
$ codex mcp add agentgrep -- pipx run --spec agentgrep agentgrep-mcp
Config file: ~/.codex/config.toml
With pipx installed:
$ codex mcp add agentgrep -- pipx run --spec agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.codex/config.toml
With pipx installed:
$ codex mcp add agentgrep -- pipx run --spec agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.codex/config.toml
With pipx installed:
Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.
[mcp_servers.agentgrep]
command = "pipx"
args = ["run", "--spec", "agentgrep", "agentgrep-mcp"]
Config file: .codex/config.toml (in repo)
With pipx installed:
Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.
[mcp_servers.agentgrep]
command = "pipx"
args = ["run", "--spec", "agentgrep", "agentgrep-mcp"]
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: .codex/config.toml (in repo)
With pipx installed:
Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.
[mcp_servers.agentgrep]
command = "pipx"
args = ["run", "--spec", "agentgrep", "agentgrep-mcp"]
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: .codex/config.toml (in repo)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ codex mcp add agentgrep -- agentgrep-mcp
Config file: ~/.codex/config.toml
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ codex mcp add agentgrep -- agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.codex/config.toml
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ codex mcp add agentgrep -- agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.codex/config.toml
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.
[mcp_servers.agentgrep]
command = "agentgrep-mcp"
Config file: .codex/config.toml (in repo)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.
[mcp_servers.agentgrep]
command = "agentgrep-mcp"
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: .codex/config.toml (in repo)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.
[mcp_servers.agentgrep]
command = "agentgrep-mcp"
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: .codex/config.toml (in repo)
With uvx installed:
$ gemini mcp add --scope user agentgrep uvx -- --from agentgrep agentgrep-mcp
Config file: ~/.gemini/settings.json
With uvx installed:
$ gemini mcp add --scope user agentgrep uvx -- --exclude-newer P7D --exclude-newer-package agentgrep=2099-01-01 --from agentgrep agentgrep-mcp
Config file: ~/.gemini/settings.json
With uvx installed:
$ gemini mcp add --scope user agentgrep uvx -- --no-config --from agentgrep agentgrep-mcp
Config file: ~/.gemini/settings.json
With uvx installed:
$ gemini mcp add --scope project agentgrep uvx -- --from agentgrep agentgrep-mcp
Config file: .gemini/settings.json (in repo)
With uvx installed:
$ gemini mcp add --scope project agentgrep uvx -- --exclude-newer P7D --exclude-newer-package agentgrep=2099-01-01 --from agentgrep agentgrep-mcp
Config file: .gemini/settings.json (in repo)
With uvx installed:
$ gemini mcp add --scope project agentgrep uvx -- --no-config --from agentgrep agentgrep-mcp
Config file: .gemini/settings.json (in repo)
With pipx installed:
$ gemini mcp add --scope user agentgrep pipx -- run --spec agentgrep agentgrep-mcp
Config file: ~/.gemini/settings.json
With pipx installed:
$ gemini mcp add --scope user agentgrep pipx -- run --spec agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.gemini/settings.json
With pipx installed:
$ gemini mcp add --scope user agentgrep pipx -- run --spec agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.gemini/settings.json
With pipx installed:
$ gemini mcp add --scope project agentgrep pipx -- run --spec agentgrep agentgrep-mcp
Config file: .gemini/settings.json (in repo)
With pipx installed:
$ gemini mcp add --scope project agentgrep pipx -- run --spec agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: .gemini/settings.json (in repo)
With pipx installed:
$ gemini mcp add --scope project agentgrep pipx -- run --spec agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: .gemini/settings.json (in repo)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ gemini mcp add --scope user agentgrep agentgrep-mcp
Config file: ~/.gemini/settings.json
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ gemini mcp add --scope user agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.gemini/settings.json
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ gemini mcp add --scope user agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.gemini/settings.json
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ gemini mcp add --scope project agentgrep agentgrep-mcp
Config file: .gemini/settings.json (in repo)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ gemini mcp add --scope project agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: .gemini/settings.json (in repo)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ gemini mcp add --scope project agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: .gemini/settings.json (in repo)
With uvx installed:
{
"mcpServers": {
"agentgrep": {
"command": "uvx",
"args": ["--from", "agentgrep", "agentgrep-mcp"]
}
}
}
Config file: .cursor/mcp.json (in repo)
With uvx installed:
{
"mcpServers": {
"agentgrep": {
"command": "uvx",
"args": ["--exclude-newer", "P7D", "--exclude-newer-package", "agentgrep=2099-01-01", "--from", "agentgrep", "agentgrep-mcp"]
}
}
}
Config file: .cursor/mcp.json (in repo)
With uvx installed:
{
"mcpServers": {
"agentgrep": {
"command": "uvx",
"args": ["--from", "agentgrep", "agentgrep-mcp"],
"env": { "UV_NO_CONFIG": "1" }
}
}
}
Config file: .cursor/mcp.json (in repo)
With uvx installed:
{
"mcpServers": {
"agentgrep": {
"command": "uvx",
"args": ["--from", "agentgrep", "agentgrep-mcp"]
}
}
}
Config file: ~/.cursor/mcp.json
With uvx installed:
{
"mcpServers": {
"agentgrep": {
"command": "uvx",
"args": ["--exclude-newer", "P7D", "--exclude-newer-package", "agentgrep=2099-01-01", "--from", "agentgrep", "agentgrep-mcp"]
}
}
}
Config file: ~/.cursor/mcp.json
With uvx installed:
{
"mcpServers": {
"agentgrep": {
"command": "uvx",
"args": ["--from", "agentgrep", "agentgrep-mcp"],
"env": { "UV_NO_CONFIG": "1" }
}
}
}
Config file: ~/.cursor/mcp.json
With pipx installed:
{
"mcpServers": {
"agentgrep": {
"command": "pipx",
"args": ["run", "--spec", "agentgrep", "agentgrep-mcp"]
}
}
}
Config file: .cursor/mcp.json (in repo)
With pipx installed:
{
"mcpServers": {
"agentgrep": {
"command": "pipx",
"args": ["run", "--spec", "agentgrep", "agentgrep-mcp"]
}
}
}
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: .cursor/mcp.json (in repo)
With pipx installed:
{
"mcpServers": {
"agentgrep": {
"command": "pipx",
"args": ["run", "--spec", "agentgrep", "agentgrep-mcp"]
}
}
}
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: .cursor/mcp.json (in repo)
With pipx installed:
{
"mcpServers": {
"agentgrep": {
"command": "pipx",
"args": ["run", "--spec", "agentgrep", "agentgrep-mcp"]
}
}
}
Config file: ~/.cursor/mcp.json
With pipx installed:
{
"mcpServers": {
"agentgrep": {
"command": "pipx",
"args": ["run", "--spec", "agentgrep", "agentgrep-mcp"]
}
}
}
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.cursor/mcp.json
With pipx installed:
{
"mcpServers": {
"agentgrep": {
"command": "pipx",
"args": ["run", "--spec", "agentgrep", "agentgrep-mcp"]
}
}
}
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.cursor/mcp.json
Install the packages first:
$ pip install --user --upgrade agentgrep
Then use this config:
{
"mcpServers": {
"agentgrep": {
"command": "agentgrep-mcp"
}
}
}
Config file: .cursor/mcp.json (in repo)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then use this config:
{
"mcpServers": {
"agentgrep": {
"command": "agentgrep-mcp"
}
}
}
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: .cursor/mcp.json (in repo)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then use this config:
{
"mcpServers": {
"agentgrep": {
"command": "agentgrep-mcp"
}
}
}
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: .cursor/mcp.json (in repo)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then use this config:
{
"mcpServers": {
"agentgrep": {
"command": "agentgrep-mcp"
}
}
}
Config file: ~/.cursor/mcp.json
Install the packages first:
$ pip install --user --upgrade agentgrep
Then use this config:
{
"mcpServers": {
"agentgrep": {
"command": "agentgrep-mcp"
}
}
}
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.cursor/mcp.json
Install the packages first:
$ pip install --user --upgrade agentgrep
Then use this config:
{
"mcpServers": {
"agentgrep": {
"command": "agentgrep-mcp"
}
}
}
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.cursor/mcp.json
With uvx installed:
$ grok mcp add --scope user agentgrep -- uvx --from agentgrep agentgrep-mcp
Config file: ~/.grok/config.toml
With uvx installed:
$ grok mcp add --scope user agentgrep -- uvx --exclude-newer P7D --exclude-newer-package agentgrep=2099-01-01 --from agentgrep agentgrep-mcp
Config file: ~/.grok/config.toml
With uvx installed:
$ grok mcp add --scope user agentgrep -- uvx --no-config --from agentgrep agentgrep-mcp
Config file: ~/.grok/config.toml
With uvx installed:
$ grok mcp add --scope project agentgrep -- uvx --from agentgrep agentgrep-mcp
Config file: ./.grok/config.toml (in repo)
With uvx installed:
$ grok mcp add --scope project agentgrep -- uvx --exclude-newer P7D --exclude-newer-package agentgrep=2099-01-01 --from agentgrep agentgrep-mcp
Config file: ./.grok/config.toml (in repo)
With uvx installed:
$ grok mcp add --scope project agentgrep -- uvx --no-config --from agentgrep agentgrep-mcp
Config file: ./.grok/config.toml (in repo)
With pipx installed:
$ grok mcp add --scope user agentgrep -- pipx run --spec agentgrep agentgrep-mcp
Config file: ~/.grok/config.toml
With pipx installed:
$ grok mcp add --scope user agentgrep -- pipx run --spec agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.grok/config.toml
With pipx installed:
$ grok mcp add --scope user agentgrep -- pipx run --spec agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.grok/config.toml
With pipx installed:
$ grok mcp add --scope project agentgrep -- pipx run --spec agentgrep agentgrep-mcp
Config file: ./.grok/config.toml (in repo)
With pipx installed:
$ grok mcp add --scope project agentgrep -- pipx run --spec agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ./.grok/config.toml (in repo)
With pipx installed:
$ grok mcp add --scope project agentgrep -- pipx run --spec agentgrep agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ./.grok/config.toml (in repo)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ grok mcp add --scope user agentgrep -- agentgrep-mcp
Config file: ~/.grok/config.toml
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ grok mcp add --scope user agentgrep -- agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.grok/config.toml
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ grok mcp add --scope user agentgrep -- agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.grok/config.toml
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ grok mcp add --scope project agentgrep -- agentgrep-mcp
Config file: ./.grok/config.toml (in repo)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ grok mcp add --scope project agentgrep -- agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ./.grok/config.toml (in repo)
Install the packages first:
$ pip install --user --upgrade agentgrep
Then register:
$ grok mcp add --scope project agentgrep -- agentgrep-mcp
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ./.grok/config.toml (in repo)
With uvx installed:
{
"mcpServers": {
"agentgrep": {
"command": "uvx",
"args": ["--from", "agentgrep", "agentgrep-mcp"]
}
}
}
Config file: ~/.gemini/config/mcp_config.json
With uvx installed:
{
"mcpServers": {
"agentgrep": {
"command": "uvx",
"args": ["--exclude-newer", "P7D", "--exclude-newer-package", "agentgrep=2099-01-01", "--from", "agentgrep", "agentgrep-mcp"]
}
}
}
Config file: ~/.gemini/config/mcp_config.json
With uvx installed:
{
"mcpServers": {
"agentgrep": {
"command": "uvx",
"args": ["--from", "agentgrep", "agentgrep-mcp"],
"env": { "UV_NO_CONFIG": "1" }
}
}
}
Config file: ~/.gemini/config/mcp_config.json
With pipx installed:
{
"mcpServers": {
"agentgrep": {
"command": "pipx",
"args": ["run", "--spec", "agentgrep", "agentgrep-mcp"]
}
}
}
Config file: ~/.gemini/config/mcp_config.json
With pipx installed:
{
"mcpServers": {
"agentgrep": {
"command": "pipx",
"args": ["run", "--spec", "agentgrep", "agentgrep-mcp"]
}
}
}
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.gemini/config/mcp_config.json
With pipx installed:
{
"mcpServers": {
"agentgrep": {
"command": "pipx",
"args": ["run", "--spec", "agentgrep", "agentgrep-mcp"]
}
}
}
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.gemini/config/mcp_config.json
Install the packages first:
$ pip install --user --upgrade agentgrep
Then use this config:
{
"mcpServers": {
"agentgrep": {
"command": "agentgrep-mcp"
}
}
}
Config file: ~/.gemini/config/mcp_config.json
Install the packages first:
$ pip install --user --upgrade agentgrep
Then use this config:
{
"mcpServers": {
"agentgrep": {
"command": "agentgrep-mcp"
}
}
}
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.gemini/config/mcp_config.json
Install the packages first:
$ pip install --user --upgrade agentgrep
Then use this config:
{
"mcpServers": {
"agentgrep": {
"command": "agentgrep-mcp"
}
}
}
pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting agentgrep itself via `--exclude-newer-package`.
Config file: ~/.gemini/config/mcp_config.json
Dependency cooldowns
Use the Configure cooldowns checkbox above to enable or disable. These settings choose how cooldown behaves once enabled.
What are cooldowns?
Cooldowns delay picking up newly uploaded packages so the community has time to spot supply-chain attacks before you install. Most package managers don't apply one by default — you opt in via a global setting in your tool's config.
Learn more at cooldowns.dev · Datadog Security Labs writeup.
Invoke search and discovery.
Read capabilities and source inventories.
Reusable client-side search recipes.
Payload models, server factory, and MCP helpers.