Loyverse MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Loyverse MCP or direct API to track sales, manage inventory, update products, and analyze customer data through natural language.
Trusted by
AWS
Glean
Zoom
Airtable
GET STARTED FOR FREEGET A DEMO

30 min · no commitment · see it on your stack

Loyverse Logo
Gradient Top
Gradient Middle
Gradient Bottom
divider

Try Loyverse now

Enter a prompt below to test the integration in our Tool Router playground. You'll be redirected to sign in and try it live.

Supported Tools

Tools
Create or Update CategoryTool to create a new category or update an existing one.
Create or Update CustomerTool to create a new customer or update an existing one in Loyverse.
Create or Update DiscountTool to create or update a single discount.
Create or Update ItemTool to create a new item or update an existing one in Loyverse inventory.
Create or Update ModifierTool to create or update a single modifier with options.
Create or Update POS DeviceTool to create a new POS device or update an existing one.
Create or Update SupplierTool to create a new supplier or update an existing one in Loyverse.
Create or Update TaxTool to create or update a single tax.
Create or Update VariantTool to create or update a single item variant in Loyverse.
Create or Update WebhookTool to create a new webhook subscription or update an existing one in Loyverse.
Create ReceiptTool to create a sales receipt with line items and payments.
Create RefundTool to create a refund receipt for a sales receipt.
Delete CategoryTool to delete a single category by ID.
Delete CustomerTool to delete a single customer by their ID.
Delete DiscountTool to delete a single discount by ID.
Delete ItemTool to delete a single item by ID.
Delete Item ImageTool to delete a single image from an item.
Delete ModifierTool to delete a single modifier by its ID.
Delete POS DeviceTool to delete a single POS device by its ID.
Delete SupplierTool to delete a specific supplier by ID.
Delete TaxTool to delete a single tax by its ID.
Delete VariantTool to delete a single item variant by its ID.
Delete WebhookTool to delete a single webhook by its ID.
Get CategoryTool to get a single category by ID.
Get CustomerTool to get a single customer by their ID.
Get DiscountTool to get a single discount by ID.
Get EmployeeTool to get a single employee by ID.
Get ItemTool to get a single item by ID including all its variants.
Get JWKSTool to fetch JSON Web Key Set for OpenID Connect.
Get Merchant InfoTool to get merchant information.
Get ModifierTool to get a single modifier by ID.
Get OpenID Connect Discovery DocumentTool to retrieve the OpenID Connect discovery document.
Get Payment TypeTool to get a single payment type by its ID.
Get POS DeviceTool to retrieve details of a specific POS device by its ID.
Get ReceiptTool to retrieve a single receipt by its receipt number.
Get StoreTool to retrieve details of a specific store by its ID.
Get SupplierTool to get a single supplier by their ID.
Get TaxTool to get a single tax by ID.
Get VariantTool to get a single item variant by its ID.
Get WebhookTool to get a single webhook by its ID.
List CategoriesTool to list categories with optional filtering and pagination.
List CustomersTool to get a list of customers.
List DiscountsTool to list discounts.
List Employees (Advanced)Tool to get a list of employees with advanced filtering options.
List InventoryRetrieves inventory levels for item variants across stores in the Loyverse system.
List ItemsRetrieves a paginated list of items (products) from the Loyverse inventory.
List Modifiers (Enhanced)Tool to get a list of modifiers sorted by created_at in descending order.
List Payment TypesTool to list payment types.
List POS DevicesTool to get a list of POS devices sorted by creation date in descending order.
List ReceiptsTool to retrieve a list of receipts.
List ShiftsTool to list shifts.
List StoresTool to get a list of stores sorted by creation date (newest first).
List SuppliersTool to retrieve a list of suppliers.
List TaxesTool to get a list of taxes sorted by creation date (newest first).
List VariantsTool to get a list of item variants sorted by creation date (newest first).
List WebhooksTool to list webhooks.
Update InventoryTool to batch update inventory levels for item variants at specific stores.
Upload Item ImageTool to upload a single image for an item.
Python
TypeScript

Install Composio

python
pip install composio claude-agent-sdk
Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
Initialize the Composio client and create a Tool Router session

Connect to AI Agent

python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Loyverse tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Get merchant information in Loyverse')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
Use the MCP server with your AI agent

Why Use Composio?

AI Native Loyverse Integration

  • Supports both Loyverse MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Loyverse data

Managed Auth

  • Built-in API key management for Loyverse
  • Central place to manage, scope, and revoke Loyverse access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Loyverse
  • Scoped, least privilege access to Loyverse resources
  • Full audit trail of agent actions to support review and compliance

Use Loyverse with any AI Agent Framework

Choose a Framework you want to connect Loyverse with

Frequently Asked Questions

Do I need my own developer credentials to use Loyverse with Composio?

Yes, Loyverse requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Get started for freeGet a demo↗