Sypha AI Docs
FeaturesTools

use_mcp_tool

Execute complex actions and interact with third-party services using the Model Context Protocol.

use_mcp_tool

The use_mcp_tool utility empowers Sypha to perform active operations on external servers via the Model Context Protocol (MCP). This is the primary mechanism Sypha uses to bridge with services like Slack, GitHub, Jira, and other mission-critical tools.

Parameters

  • server_name (required): The designated name of the connected MCP server.
  • tool_name (required): The specific operation to be executed (e.g., create_github_issue).
  • arguments (optional): A JSON-formatted object providing the necessary data for the tool's execution.

Functional Domain

While Sypha's native tools manage local file systems and terminals, MCP tools coordinate external environment interactions:

  • Team Communication: Transmitting updates to Slack, MS Teams, or email.
  • Workflow Orchestration: Initializing Jira tickets, GitHub Issues, or managing project boards.
  • Advanced Computational Logic: Interfacing with services like Wolfram Alpha for math or executing queries against proprietary SQL databases.

Security Governance

By default, every invocation of an MCP tool requires manual user approval. You can review the complete JSON argument list before authorizing the operation. For frequently used, high-trust tools, you can enable Always Allow within the MCP Integrated Settings.

Implementation Example

Broadcasting to a Slack channel

<use_mcp_tool>
  <server_name>corporate-slack</server_name>
  <tool_name>post_channel_message</tool_name>
  <arguments>
    {
      "channel": "engineering-ops",
      "text": "Deployment of the new API layer is complete and ready for staging tests."
    }
  </arguments>
</use_mcp_tool>

Maintenance & Resolution

If a tool fails to respond, consult the MCP Servers dashboard within Sypha's settings to verify the server heartbeat and ensure your mcp_settings.json credentials remain valid.

On this page