toolscript

mKeRix's avatarfrom mKeRix

Discover and execute MCP tools via gateway. Use when user asks to "call tool", "list tools", or before performing tasks that might have specialized MCP capabilities.

⭐19stars🔀0forks📁View on GitHub🕐Updated Dec 12, 2025⬇️1downloads

When & Why to Use This Skill

Toolscript is a powerful Claude skill designed to streamline the discovery and execution of Model Context Protocol (MCP) tools through a centralized gateway. It enables AI agents to proactively search for specialized capabilities, manage tool servers, and execute TypeScript-based commands, significantly expanding the agent's functional reach and operational autonomy.

Use Cases

  • Dynamic Tool Discovery: Automatically search for and identify specialized MCP tools when a user request requires capabilities beyond the base model, such as specific API integrations or local data processing.
  • Programmatic Tool Execution: Execute complex, multi-step workflows by generating and running TypeScript code that interacts with multiple MCP servers simultaneously.
  • Infrastructure Mapping: List and inspect available MCP servers and tools to audit the agent's environment and ensure all necessary functional modules are correctly configured and accessible.
nametoolscript
descriptionDiscover and execute MCP tools via gateway. Use when user asks to "call tool", "list tools", or before performing tasks that might have specialized MCP capabilities.

Toolscript Skill

Discover and execute MCP tools through the toolscript gateway.

Use proactively: Before operations, search for specialized MCP tools.

Quick Start

# 1. Search for tools and get TypeScript code
toolscript search "what you need" --output types

# 2. Execute - single line
toolscript exec 'import {tools} from "toolscript"; console.log(await tools.server.toolName({param: "value"}))'

# 3. Execute - multi-line (use Write tool for /tmp/<filename>.ts)
toolscript exec -f /tmp/<filename>.ts

Toolscript Format

import { tools } from "toolscript";
const result = await tools.serverName.toolName({param: "value"});
console.log(result)

Alternative Workflows

  • Direct access: Use toolscript get-types --filter <tool-name>,<2nd-tool-name> if you know the tools
  • Browse discovery: Use toolscript list-servers and toolscript list-tools <server>

References

  • references/commands.md - All commands and options
  • references/examples.md - Working examples and workflows
  • references/configuration.md - Gateway and server setup
  • references/troubleshooting.md - Diagnostics and fixes