AgentPMT/multi-protocol-bridge

Multi-Protocol Bridge

Freshness

Last updated: 2026-06-23.

If the current date is more than 7 days after the last updated date, reinstall this skill from skills.sh or ClawHub before relying on endpoints, schemas, setup steps, or examples.

What This Tool Does

Protocol Bridge is an HTTP gateway that enables AI agents, automation workflows, and modern applications to interact with traditional network protocols without native protocol support. It translates simple HTTP requests into FTP, SSH, and MQTT operations, making it easy to integrate file transfers, remote command execution, and IoT messaging into any system that can make web requests. The tool supports secure connections including FTPS, SSH key authentication, and MQTTS with TLS, ensuring enterprise-grade security for sensitive operations. Connection details can be passed via intuitive URL strings or explicit parameters, giving developers flexibility in how they configure each action. Protocol Bridge is ideal for building automation pipelines, connecting legacy infrastructure to modern APIs, orchestrating DevOps tasks, and enabling large language models to perform real-world actions across diverse systems. For email sending workflows, use the dedicated SMTP Mailer tool which provides a streamlined interface specifically optimized for email delivery.

Product Instructions

Multi-Protocol Bridge

Access FTP, SSH, and MQTT protocols through a unified HTTP interface. All actions use a URL-first approach where connection details (host, port, credentials, path) are encoded in the URL.

URL Format

All actions require a protocol URL:

scheme://username:password@hostname:port/path

Supported schemes:

• ftp:// / ftps:// (FTP with optional TLS)
• ssh:// (SSH remote commands)
• mqtt:// / mqtts:// (MQTT with optional TLS)

---

Actions

ftp_upload

Upload a file to an FTP/FTPS server.

Required fields:

• action: "ftp_upload"
• url: FTP URL with path to the destination file (scheme must be ftp:// or ftps://)
• content: File content to upload (text or base64-encoded)

Optional fields:

• content_encoding: "text" (default) or "base64" for binary files

Example:

{
  "action": "ftp_upload",
  "url": "ftp://myuser:[email protected]:21/uploads/report.txt",
  "content": "Monthly report data here..."
}

Example (binary file):

{
  "action": "ftp_upload",
  "url": "ftps://myuser:[email protected]:21/images/logo.png",
  "content": "iVBORw0KGgoAAAANSUhEUg...",
  "content_encoding": "base64"
}

Limits: Maximum file size is 100 MB.

---

ftp_download

Download a file from an FTP/FTPS server.

Required fields:

• action: "ftp_download"
• url: FTP URL with path to the file to download (scheme must be ftp:// or ftps://)

Optional fields:

• options.return_base64 (boolean): Return file content as base64 instead of text. Default: false. Use this for binary files.

Example:

{
  "action": "ftp_download",
  "url": "ftp://myuser:[email protected]:21/reports/q1.csv"
}

Example (binary download):

{
  "action": "ftp_download",
  "url": "ftps://myuser:[email protected]:21/images/photo.jpg",
  "options": { "return_base64": true }
}

Limits: Maximum file size is 100 MB. Non-text files that fail UTF-8 decoding are automatically returned as base64.

---

ftp_list

List the contents of a directory on an FTP/FTPS server.

Required fields:

• action: "ftp_list"
• url: FTP URL with path to the directory (scheme must be ftp:// or ftps://)

Optional fields:

• options.recursive (boolean): List subdirectories recursively. Default: false

Example:

{
  "action": "ftp_list",
  "url": "ftp://myuser:[email protected]:21/documents/"
}

Example (recursive):

{
  "action": "ftp_list",
  "url": "ftp://myuser:[email protected]:21/project/",
  "options": { "recursive": true }
}

Limits: Results are capped at 1,000 entries.

---

ftp_delete

Delete a file on an FTP/FTPS server. Requires explicit confirmation.

Required fields:

• action: "ftp_delete"
• url: FTP URL with path to the file to delete (scheme must be ftp:// or ftps://)
• options.confirm_delete: Must be the string "DELETE" to confirm deletion

Example:

{
  "action": "ftp_delete",
  "url": "ftp://myuser:[email protected]:21/old-files/archive.zip",
  "options": { "confirm_delete": "DELETE" }
}

---

ssh_execute

Execute a shell command on a remote server via SSH.

Required fields:

• action: "ssh_execute"
• url: SSH URL (scheme must be ssh://)
• content: The shell command to execute

Optional fields:

• options.timeout (integer): Command timeout in seconds. Default: 30
• options.private_key (string): SSH private key in PEM format for key-based authentication. When provided, password in the URL can be omitted.
• options.known_hosts (string): SSH known hosts entry for host verification

Example (password auth):

{
  "action": "ssh_execute",
  "url": "ssh://deploy:[email protected]:22",
  "content": "df -h && uptime"
}

Example (key-based auth):

{
  "action": "ssh_execute",
  "url": "ssh://[email protected]:22",
  "content": "ls -la /var/log",
  "options": {
    "private_key": "-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----",
    "timeout": 60
  }
}

Limits: Command output (stdout/stderr) is capped at 10 MB each.

---

mqtt_publish

Publish a message to an MQTT broker.

Required fields:

• action: "mqtt_publish"
• url: MQTT URL with the topic as the path (scheme must be mqtt:// or mqtts://)
• content: Message payload (plain text or JSON string)

Optional fields:

• options.qos (integer): Quality of Service level. 0 = at most once (default), 1 = at least once, 2 = exactly once.
• options.retain (boolean): Broker retains the message for future subscribers. Default: false
• options.client_id (string): MQTT client identifier. Auto-generated if not provided.

Example:

{
  "action": "mqtt_publish",
  "url": "mqtt://sensoruser:[email protected]:1883/sensors/temperature",
  "content": "{\"value\": 22.5, \"unit\": \"celsius\"}"
}

Example (with QoS and retain):

{
  "action": "mqtt_publish",
  "url": "mqtts://admin:[email protected]:8883/alerts/critical",
  "content": "Server CPU above 95%",
  "options": { "qos": 2, "retain": true, "client_id": "monitoring-agent" }
}

Limits: Payload size is capped at 1 MB.

---

Common Workflows

Deploy a file and verify it exists

1. Use ftp_upload to upload the file.
2. Use ftp_list on the parent directory to confirm it appears.

Remote server health check

1. Use ssh_execute with a command like uptime && free -m && df -h to get server status.

IoT data publishing

1. Use mqtt_publish to send sensor readings to a topic with qos: 1 for guaranteed delivery.

Secure file transfer

1. Use ftps:// scheme for encrypted FTP connections.
2. Use mqtts:// scheme for encrypted MQTT connections.
3. Use options.private_key for SSH key-based authentication.

---

Important Notes

• URL encoding: Special characters in usernames or passwords must be URL-encoded (e.g., @ becomes %40).
• Default ports: FTP uses 21, SSH uses 22, MQTT uses 1883, MQTTS uses 8883. You can omit the port to use the default.
• FTP anonymous access: If no username is provided, connections default to anonymous access.
• Delete safety: The ftp_delete action requires options.confirm_delete set to "DELETE" as a safeguard.
• Binary files: Use content_encoding: "base64" for uploading binary files and options.return_base64: true for downloading them.
• SSH authentication: Provide either a password in the URL or a private_key in options, not both.

When To Use

• Use this skill for Multi-Protocol Bridge on AgentPMT.
• Use it when an agent needs this specific tool's behavior, schema, inputs, outputs, and invocation shape.
• Search and activation keywords: multi protocol bridge, ftp file upload automation, ftp file download, secure ftps file transfer, remote directory listing, ftp delete, url, options.
• Supported action names: ftp_delete, ftp_download, ftp_list, ftp_upload, mqtt_publish, ssh_execute.

Use Cases

• FTP file upload automation
• FTP file download
• secure FTPS file transfer
• remote directory listing
• automated file deletion
• SSH remote command execution
• server administration automation
• DevOps task orchestration
• IoT MQTT message publishing
• sensor data transmission
• smart home device control
• MQTT broker integration
• AI agent protocol access
• LLM tool integration
• workflow automation
• legacy system integration

Categories And Industries

No categories or industry tags are published for this tool.

Actions And Schema

Complete generated action schema: ./schema.md. Supported action count: 6. x402 availability: not enabled for this product.

• ftp_delete (action slug: ftp-delete): Delete a file on an FTP or FTPS server. Requires explicit confirmation via options.confirm_delete. Price: 5 credits. Parameters: options, url.
• ftp_download (action slug: ftp-download): Download a file from an FTP or FTPS server. Returns file content as text or base64. Price: 5 credits. Parameters: options, url.
• ftp_list (action slug: ftp-list): List the contents of a directory on an FTP or FTPS server. Price: 5 credits. Parameters: options, url.
• ftp_upload (action slug: ftp-upload): Upload a file to an FTP or FTPS server. Supports text and base64-encoded binary content. Price: 5 credits. Parameters: content, content_encoding, url.
• mqtt_publish (action slug: mqtt-publish): Publish a message to an MQTT or MQTTS broker. The topic is specified as the URL path. Price: 5 credits. Parameters: content, options, url.
• ssh_execute (action slug: ssh-execute): Execute a shell command on a remote server via SSH. Supports password and key-based authentication. Price: 5 credits. Parameters: content, options, url.

Live Schema And Examples

Use the compact schema above for ordinary calls. Before a new production integration, or whenever parameters, enum values, nested objects, outputs, or examples are unclear, fetch live details first.

• Exact schema: call agentpmt-tool-search-and-execution with action: "get_schema", and tool_id: "multi-protocol-bridge".
• Detailed examples: call agentpmt-tool-search-and-execution with action: "get_instructions" and tool_id: "multi-protocol-bridge", or call this product with action: "get_instructions" when the product tool is already selected.
• Treat returned live schema and instructions as more specific than this generated summary.

MCP schema lookup through the main AgentPMT MCP server:

{
  "method": "tools/call",
  "params": {
    "name": "AgentPMT-Tool-Search-and-Execution",
    "arguments": {
      "action": "get_schema",
      "tool_id": "multi-protocol-bridge"
    }
  }
}

For live examples, keep the same MCP tool and use these arguments:

{
  "action": "get_instructions",
  "tool_id": "multi-protocol-bridge"
}

Authenticated AgentPMT REST schema lookup body:

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_schema",
    "tool_id": "multi-protocol-bridge"
  }
}

Authenticated AgentPMT REST live examples body:

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_instructions",
    "tool_id": "multi-protocol-bridge"
  }
}

Call This Tool

Product slug: multi-protocol-bridge

Marketplace page: https://www.agentpmt.com/marketplace/multi-protocol-bridge

• AgentPMT account route: first use ../agentpmt-account-mcp-rest-api-setup to connect the main MCP server or REST API for an Agent Group where this tool is enabled.
• x402 route: not enabled for this product.
• AgentPMT overview: use ../what-is-agentpmt for marketplace, Agent Group, workflow, MCP, REST, and payment concepts.

If those setup skills are not installed beside this product skill, use the downloads below.

Core AgentPMT setup skills:

• What AgentPMT is: ../what-is-agentpmt
  • ClawHub page: https://clawhub.ai/agentpmt/what-is-agentpmt
  • OpenClaw install: openclaw skills install what-is-agentpmt
  • skills.sh install: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
• AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup
  • ClawHub page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup
  • OpenClaw install: openclaw skills install agentpmt-account-mcp-rest-api-setup
  • skills.sh install: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

skills.sh install script:

npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

MCP call shape after the main AgentPMT MCP server is connected:

{
  "method": "tools/call",
  "params": {
    "name": "Multi-Protocol-Bridge",
    "arguments": {
      "action": "ftp_delete",
      "options": {
        "confirm_delete": "example confirm delete"
      },
      "url": "https://example.com"
    }
  }
}

Use the exact tool name returned by tools/list; the name above is the expected readable form.

Authenticated AgentPMT REST call body:

{
  "name": "multi-protocol-bridge",
  "parameters": {
    "action": "ftp_delete",
    "options": {
      "confirm_delete": "example confirm delete"
    },
    "url": "https://example.com"
  }
}

Use the setup skill for the account connection details before making REST calls.

Response Handling

• Treat the returned JSON as the source of truth for this tool call.
• If the response includes warnings or correction targets, apply them before retrying.
• If the response includes a passed or success-style boolean, use it as the workflow gate.
• If validation fails or the response shape is unclear, call get_schema or get_instructions before retrying.
• If ftp_delete fails, preserve the request parameters and retry only after fixing schema, auth, or payment errors.

Security

• Do not place account secrets, wallet private keys, mnemonics, signatures, or payment headers in prompts or logs.
• Keep tool inputs scoped to the minimum content needed for the task.
• Use the setup skills for credential handling; this product skill only defines product-specific behavior.

AgentPMT Reference

• What AgentPMT is: ../what-is-agentpmt (ClawHub: what-is-agentpmt, page: https://clawhub.ai/agentpmt/what-is-agentpmt; skills.sh: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt)
• AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup (ClawHub: agentpmt-account-mcp-rest-api-setup, page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup; skills.sh: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup)
• Marketplace product: https://www.agentpmt.com/marketplace/multi-protocol-bridge
• AgentPMT main MCP server: https://api.agentpmt.com/mcp/
• AgentPMT REST invoke endpoint: https://api.agentpmt.com/products/purchase