MCP Server (Beta)

Connect your AI assistant to Merchant Hub with the Model Context Protocol (MCP). Search orders, look up settlements, and list transactions by asking in plain language, from the tools you already use.

Beta

The MCP Server is in beta. Tools and endpoints may change without prior notice. Your feedback helps us shape it, so tell us what works and what doesn't.

Have a use case in mind?

We want to hear how you plan to use the MCP Server. If you need more tools or a different way of working with your data, contact us and we'll look at it together.

Why connect Merchant Hub to your AI assistant?

Today, getting the full picture of an order means logging in to Merchant Hub, then switching to your ERP, order management system, and e-commerce platform to piece it together. That takes time, and the answer lives in four places.

With MCP, your team works in one place. Connect the Merchant Hub MCP Server alongside MCP servers for your ERP, OMS, and e-commerce platform, and your assistant can pull data from all of them in the same conversation. Ask a question, compare records across systems, spot discrepancies, and get insights across your whole system landscape without leaving the chat.

Some examples of what that looks like in practice:

• Compare the payout in a Walley settlement with the corresponding invoices in your ERP.
• Find orders that are activated in Merchant Hub but still open in your OMS.
• Ask why a customer's order shows a different amount in your webshop than in Merchant Hub.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants call external systems through a defined set of capabilities called tools. The Walley MCP Server exposes Merchant Hub operations as MCP tools. Any MCP-compatible client, such as Microsoft 365 Copilot, GitHub Copilot in VS Code, or your own chat bot, can then work with your merchant data in a conversation.

Before you start

You need:

• A Merchant Hub account with access to the data you want to work with. See Permissions.
• An MCP client that supports HTTP transport.
• Credentials for one of the authentication methods below.

Environments

Environment	MCP endpoint
Test	https://merchanthub-mcp.aks.uat.walleydev.com/mcp
Production	https://mcp.merchanthub.walleypay.com/mcp

Authentication

The MCP Server supports two ways to authenticate:

• Browser flow. For interactive use. Your MCP client opens a browser where you sign in with your Merchant Hub account. Contact us to have this enabled for your organization.
• Client credentials flow. For automated integrations. Use a client ID and secret to request a Bearer token with the OAuth 2.0 Client Credentials grant.

The Authentication page describes how to request a token with the client credentials flow.

Connecting your AI client

The MCP Server uses Streamable HTTP transport. The exact configuration depends on your client, but every client needs the same two values:

• URL. The MCP endpoint for your environment from the Environments table.
• Headers. An Authorization header with your Bearer token.

Example: VS Code and GitHub Copilot

1. Open .vscode/mcp.json in your workspace, or your VS Code user settings.

2. Add the server configuration. Replace YOUR_ACCESS_TOKEN with a token from the Authentication page.

   {
     "servers": {
       "walley-merchanthub": {
         "type": "http",
         "url": "https://merchanthub-mcp.aks.uat.walleydev.com/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_ACCESS_TOKEN"
         }
       }
     }
   }

3. Start the server from VS Code. The tools listed below appear in your assistant.

Available tools

Once connected, your AI assistant can use these tools:

Tool	Description
SearchOrder	Search orders with pagination, sorting, and full-text filtering. Supports date filters on placedAt and expiresAt.
GetOrderById	Fetch a single order by its ID.
SearchSettlement	Search settlements (reports) with pagination, sorting, and full-text filtering. Supports date filters on startDate, endDate, and paidOutAt.
GetSettlementTransactions	Fetch the transactions for a settlement by its ID, with pagination support.

Usage examples

Once connected, you can ask your assistant things like:

• "Show me orders placed in the last 7 days"
• "Find order 12345 and show me its details"
• "Search for orders with status 'Activated'"
• "Show me settlements paid out this month"
• "List the transactions for settlement ABC-123"

Permissions

The MCP Server uses the same permissions as Merchant Hub. Which tools are available, and which data they return, depends on the permissions of the authenticated user. If a tool returns an authorization error, check the user's permissions under Manage Organization in Merchant Hub. See User and group management for details.

Data security

Your data goes to the AI model

When you use the MCP Server with an AI assistant, order and settlement data is sent to the AI model for processing. This data can include personal and sensitive information.

You are responsible for making sure it is not leaked or exposed to unauthorized parties. That includes evaluating the AI tools and models you connect, complying with applicable data protection regulations such as GDPR, and restricting access to authorized personnel. Walley is not responsible for data handling that happens outside the MCP Server itself.