Expose a Workflow as an MCP Tool
Turn any Tensorify workflow into a tool that AI agents (Claude Desktop, Cursor, custom agents) can discover and call via the Model Context Protocol.
- A Tensorify account with an API key
- A workflow you want to expose
- An MCP-compatible client (Claude Desktop, Cursor, etc.)
- Open the Tensorify canvas
- Drag the MCP Trigger node from the plugin panel
- Configure:
- Tool Name: A snake_case identifier (e.g.
search_knowledge_base) - Tool Description: Clear description of what the tool does
- Input Parameters: JSON Schema defining accepted arguments
- Tool Name: A snake_case identifier (e.g.
Connect the MCP Trigger output to your workflow logic. The trigger emits:
mcp.arguments— the full args object from the AI agentmcp.arguments.*— individual parameters (e.g.mcp.arguments.query)
Use these in your workflow nodes via bindings.
Add a Return node at the end of your workflow. The value you return gets sent back to the AI agent as the tool result.
{
"results": [...],
"count": 5
}
- Click Deploy in the workflow header
- Choose your execution mode (Cloud or Self-Hosted)
- After deployment, you'll see the MCP Server URL
Add to ~/.config/Claude/claude_desktop_config.json:
{
"mcpServers": {
"tensorify-tools": {
"url": "https://mcp.tensorify.io/v1/triggers",
"headers": {
"Authorization": "Bearer tfk_your_api_key"
}
}
}
}
Add to .cursor/mcp.json in your project:
{
"mcpServers": {
"tensorify-tools": {
"url": "https://mcp.tensorify.io/v1/triggers",
"headers": {
"Authorization": "Bearer tfk_your_api_key"
}
}
}
}
Run tensorify mcp config to generate these snippets automatically with your API key pre-filled.
Restart your MCP client. The tool should now appear in the available tools list. Ask the AI to use it:
"Search my knowledge base for information about pricing"
The AI will call your search_knowledge_base tool with the appropriate arguments.
- Be descriptive: The tool description is what helps the AI decide when to use your tool. Write it like you're explaining it to a colleague.
- Validate parameters: Use JSON Schema's
requiredfield anddescriptionon each property. - Set appropriate timeouts: If your workflow takes time (API calls, database queries), increase the timeout from the default 30 seconds.
- Use response mode wisely:
use-workflow-responseis best for tools that return data.ack-immediatelyis for fire-and-forget operations.
