<< All versions

Skill v1.0.1

currentAutomated scan100/100
lordfarquaadthecreator/agents-skills/mcp-bridge

+5 new

──Details
PublishedOctober 24, 2026 at 01:49 AM
Content Hashsha256:516bf948bc072f7e...
Git SHAbddac7981b1a
Bump Typepatch
Compare with v1.0.0
──Files
Files (1 file, 3.5 KB)
SKILL.md3.5 KBactive
SKILL.md · 114 lines · 3.5 KB

version: "1.0.1" name: mcp-bridge description: Call any MCP server binary from shell without registration. Use when an MCP is not registered but the binary is available on disk. Replaces ad-hoc JSON-RPC scripts.


MCP Bridge

Call any MCP server binary via a CLI wrapper. No registration required. No JSON-RPC knowledge required.

Prerequisites

Build the wrapper once:

bash
cd ~/agents-skills/skills/mcp-bridge/scripts/mcp-call/
go build -o mcp-call .

Binary lives at ~/agents-skills/skills/mcp-bridge/scripts/mcp-call/mcp-call.

Usage

bash
mcp-call <command...> -- <list|call|describe> [flags]

The -- separator splits the MCP server command from the wrapper subcommand.

Subcommands

SubcommandPurposeExample
listDiscover available toolsmcp-call /path/to/binary -- list
call <tool>Call a tool with JSON argsmcp-call /path/to/binary -- call generate_story_pdf --args '{"title":"Test"}'
describe <tool>Show tool schema + descriptionmcp-call /path/to/binary -- describe generate_story_pdf

Flags

FlagPurposeDefault
--args '<json>'JSON arguments for call{}
--env KEY=VALSet env var on spawned process. Repeatable.inherited from parent
--timeout 120sTimeout for the operation120s

Output

  • Text content → printed to stdout
  • Image content → saved to temp file, path printed to stdout
  • Errors → stderr, exit code 1

Known MCPs

MCPCommandEnv varsTools
create-story~/agents-skills/mcps/create-story/create-storynonegenerate_story_pdf
create-image~/agents-skills/mcps/create-image/create-imageCOMFY_HEADLESS_URLlist_loras, list_base_models, generate_image
cover-letter-writter~/agents-skills/mcps/cover-letter-writter/cover-letter-writter(check AGENTS.md)7 tools

For Docker-based MCPs, use docker run --rm -i <image> as the command:

bash
mcp-call docker run --rm -i create-story -- list

Examples

List tools

bash
~/agents-skills/skills/mcp-bridge/scripts/mcp-call/mcp-call \
~/agents-skills/mcps/create-story/create-story -- list

Call a tool

bash
~/agents-skills/skills/mcp-bridge/scripts/mcp-call/mcp-call \
~/agents-skills/mcps/create-story/create-story -- \
call generate_story_pdf --args '{"title":"My Story","pages":[{"image":"/path/to/img.png","text":"Once upon a time."}]}'

Call with env vars

bash
~/agents-skills/skills/mcp-bridge/scripts/mcp-call/mcp-call \
~/agents-skills/mcps/create-image/create-image -- \
call list_loras \
--env COMFYUI_API_URL=https://your-endpoint.modal.run

Describe a tool (get schema)

bash
~/agents-skills/skills/mcp-bridge/scripts/mcp-call/mcp-call \
~/agents-skills/mcps/create-story/create-story -- \
describe generate_story_pdf

Workflow

  1. Discover: list to see available tools
  2. Inspect: describe <tool> if you need arg schema
  3. Call: call <tool> --args '<json>' with the arguments
  4. Parse: stdout has the result. Image paths on their own lines.

Tips

  • Always use list first on an unknown MCP to discover tool names
  • Use describe to get exact arg schema before constructing --args
  • For long-running tools (image generation), the default 120s timeout should suffice. Override with --timeout 300s if needed
  • Multiple --env flags can be passed: --env KEY1=VAL1 --env KEY2=VAL2
  • Args JSON must be valid JSON. Use single quotes around the whole string
← v1.0.0All versions