loyverse-automation

Loyverse Automation - Rube MCP Integration Guide

Skill Overview

Automate Loyverse operations using Rube MCP and the Composio toolset, enabling inventory management, order processing, and other workflow automations without needing API keys.

Use Cases

1. Inventory and Order Automation

Suitable for retail and restaurant merchants that need to automatically update inventory status and process orders in bulk. With RUBE_MULTI_EXECUTE_TOOL, you can execute multiple Loyverse actions at once, reducing manual entry errors and improving processing efficiency.

2. Workflow Integration and Customization

Suitable for developers who want to embed Loyverse into larger business workflows—for example, integrating with CRM systems, accounting software, or custom dashboards. Using RUBE_REMOTE_WORKBENCH allows you to flexibly orchestrate complex cross-system operations in a Python environment.

3. Rapid Prototyping and Testing

Suitable for scenarios where you want to explore Loyverse integration possibilities without applying for official API credentials. Simply add the Rube MCP endpoint https://rube.app/mcp in the client configuration to get started.

Core Features

1. Dynamic Tool Discovery and Schema Validation

Use RUBE_SEARCH_TOOLS to always retrieve the latest tool schemas, recommended execution plans, and known pitfalls. This ensures automation scripts continue to work correctly even after the tool API updates, avoiding runtime failures caused by hardcoded tool slugs or parameters.

2. Connection Status Management

RUBE_MANAGE_CONNECTIONS provides real-time checks of the Loyverse connection status. Before executing any operation, it verifies that the connection is ACTIVE. It also supports completing the first authorization via the returned authentication link, ensuring the workflow runs under the correct connection state.

3. Flexible Execution Modes

Single-step execution: Use RUBE_MULTI_EXECUTE_TOOL to pass discovered tool slugs and schema-compliant parameters

Batch operations: Use RUBE_REMOTE_WORKBENCH to call run_composio_tool() for large-scale data processing

Full mode: Use RUBE_GET_TOOL_SCHEMAS to retrieve complete input/output definitions for tools that include schemaRef

FAQs

How does Loyverse Automation work without an API key?

Rube MCP provides an intermediary layer. You only need to add the MCP server endpoint https://rube.app/mcp to your client configuration. When connecting to Loyverse, RUBE_MANAGE_CONNECTIONS returns an authentication link. After completing the first authorization, you can use it immediately—no need to separately request API keys or manage credentials.

Do tool modes change, and why do I have to search every time?

Yes. The Composio toolset is updated periodically to support new Loyverse features. RUBE_SEARCH_TOOLS returns not only the list of currently available tools and slugs, but also the input schema, recommended execution plan, and known pitfalls. Always calling this step ensures your automation script keeps working after API updates.

How can I execute Loyverse actions in bulk?

There are two approaches:
1) Use the tools array parameter of RUBE_MULTI_EXECUTE_TOOL to pass multiple tool calls at once.
2) Use RUBE_REMOTE_WORKBENCH to write loop logic in your Python environment, repeatedly calling run_composio_tool() to process large volumes of data. When handling many operations, remember to check pagination markers in the responses.