Skip to content
Agentmart
Submit a tool

Tool Guardian

MCP router that keeps tool definitions out of the context window and finds tools on demand.

Connector by LuminariSoftwares · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 2
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/luminarisoftwares-tool-guardian

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

MCP router that keeps tool definitions out of the context window and finds tools on demand.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
9 read · 3 write · 0 delete · 3 not yet classified
Secrets
None asked for
Install scripts
None found
Runs as
Python package

Tools by what they do 15

Read from the source code; the running server may list different tools.

Read 9 · Look things up without changing anything.

  • describe_tool
  • find_notes
  • get_counter
  • list_capabilities
  • list_groups_with_costs
  • list_skills
  • read_skill
  • retrieve_spill
  • search_capabilities

Write 3 · Create, change, send or run things.

  • add_note
  • call_tool
  • restore_groups

Not yet classified 3 · We could not tell from the name and description.

  • a
  • activate_group
  • toolguardian

Network hosts it talks to 4

  • docs.astral.sh · found in code
  • docs.docker.com · found in code
  • github.com · found in code
  • glama.ai · found in code

Files it touches

  • Your home directory (~)
  • ~/.tool-guardian
  • ~/.tool-guardian/mcp.json

Tools (15)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • a
  • activate_group

    Description is built at runtime.

  • add_note

    Add a note with a title and optional body and tags.

  • call_tool

    Invoke a tool on a connected server. THIS IS THE STEP THAT ANSWERS THE USER -- list_capabilities only finds the name. `server`/`tool` are catalogue names. Side effects are the backend tool's own. Returns its result as text, big ones via retrieve_spill.

  • describe_tool

    Get the arguments of ONE backend tool, before call_tool. `server`/`tool` are catalogue names; an unknown one returns the valid ones. Read-only. Returns each argument and its type.

  • find_notes

    Find notes matching every filter in params.filters.

  • get_counter

    Return the current value of the notes counter.

  • list_capabilities

    Description is built at runtime.

  • list_groups_with_costs

    Tool GROUPS with the context-token cost of loading each; to find a tool use list_capabilities. Read-only. Returns a line per group and the totals.

  • list_skills

    Description is built at runtime.

  • read_skill

    Get the full text of one skill. Use after list_skills, once you know which skill applies; an unknown name returns the list of valid names instead. Read-only: reads one file from a configured skill folder, never a path you pass. Returns the SKILL.md text.

  • restore_groups

    Load the tool groups the PREVIOUS session activated (list_groups_with_costs shows them and their cost). Optional: call it only when this task needs the same tools.

  • retrieve_spill

    Read back the FULL original of a result call_tool shortened, by the id in its notice; an unknown or pruned id fails saying so. Read-only. Returns a text window, or grep's lines.

  • search_capabilities

    Find a tool by keyword on every connected server; cheaper than list_capabilities when you know roughly what you want. Read-only. Returns a line per match, best first, with args.

  • toolguardian

    Tool Guardian: selftest (backends, token saving, update) · bypass [last|24h] · restore

Signals

Stars
2
Forks
0
Open issues
0
Weekly downloads
167
Last commit
Oct 24, 2026 (5 days ago)
Last release
Oct 24, 2026 (5 days ago)
Last package publish
Oct 24, 2026 (5 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.LuminariSoftwares/tool-guardian
Version
0.8.1
Auth
No auth
Packages
pypi tool-guardian
License
MIT
Repository
github.com/LuminariSoftwares/tool-guardian
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql

More from LuminariSoftwares

Cite this page

Tool Guardian MCP server. Agent Mart. https://agentmart.dev/connectors/luminarisoftwares-tool-guardian (last updated 2026-10-24)