Agent skill

mcp-toolbox

Use when working with or extending the local Codex MCP toolset/server that exposes HTTP endpoints for shell, filesystem, git, and Excel operations, or when a task should be executed by calling those MCP endpoints instead of local tools, especially if the MCP server is running.

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/ironkid90/ai-agents-swiss-knife/tree/main/skills/mcp-toolbox

SKILL.md

MCP Toolbox

Prefer MCP endpoints when they can satisfy the request and the server is reachable.

Quick start

  • Ask whether the MCP server is running if it is not already clear.
  • If uncertain, do a lightweight reachability check (for example, a /shell/exec call with a harmless command) before assuming the server is unavailable.
  • Use endpoint details and payload shapes from references/toolbox.md.

Guided workflow

  • Confirm the server base URL and whether it is running.
  • Call /health to verify reachability; if it fails, fall back to local tools or ask to start the server.
  • Use /tools/list or /openapi.json to discover tool schemas for auto-invocation.
  • Use the smallest endpoint that satisfies the request; avoid local shell when /shell/exec can do it.
  • Keep file paths within MCP_ALLOWED_BASE; ask for a relative path if unsure.
  • Follow inspect -> read_range -> preview_write -> commit_write for Excel edits.
  • Show /git/status or /git/diff before /git/commit and remind that commit stages all changes.

Using the endpoints

  • Route shell commands through /shell/exec instead of local execution when the server is live.
  • Use /fs/read and /fs/write for file operations; respect the allowed base directory enforced by the server.
  • Use /git/status and /git/diff before /git/commit; note that /git/commit stages all changes.
  • For Excel edits, always call /excel/preview_write before /excel/commit_write to validate changes.

Maintaining or extending the server

  • Edit the tool modules in server/tools/ and wire them into server/mcp_server.py.
  • Keep path resolution and safety checks aligned with server/config.py (ALLOWED_BASE_DIR and MAX_READ_BYTES).
  • Update README.md if endpoints, behavior, or setup steps change.
  • When adding dependencies, update server/requirements.txt.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

mattpocock/skills

handoff

Compact the current conversation into a handoff document for another agent to pick up.

111,310 9,758
Explore
mattpocock/skills

edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

111,310 9,758
Explore
mattpocock/skills

setup-pre-commit

Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.

111,310 9,758
Explore
mattpocock/skills

obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

111,310 9,758
Explore
mattpocock/skills

git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

111,310 9,758
Explore
mattpocock/skills

migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

111,310 9,758
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results