Available Tools & Data

The SeQura MCP server provides comprehensive access to merchant data and operational capabilities for managing your business directly through AI assistants.

Financial Data Access

List Disbursements

Get an overview of all your disbursements with sorting and filtering capabilities.

Includes:

• Disbursement reference and UUID
• Amount and currency
• Issue date and status
• Most recent disbursements shown first

Example queries:

• "Show me all disbursements from last month"
• "List disbursements issued in the last 7 days"

Show Disbursement Details

Access detailed breakdowns of specific disbursements for complete financial transparency.

Includes:

• Summary: Total amount, dates, currency, current state
• Settlements: Transaction-level details for each order
  • Order references (primary & secondary)
  • Transaction amounts with tax calculations
  • Product and shipment information
• Fee Structure: Complete breakdown including:
  • Fixed fees
  • Variable fees
  • Shopper fees
  • VAT calculations
• Adjustments: Retentions and cost of credit

Example queries:

• "Show me the details for disbursement REF-12345"
• "What settlements are included in disbursement REF-67890?"

---

Order Management

Search Orders

Find orders using flexible search criteria with support for pagination and multi-parameter filtering.

Search by:

• Date ranges (from/to dates)
• Order status (confirmed, shipped, partially_shipped, cancelled)
• Reference patterns (primary or secondary)
• Amount ranges
• Customer information
• Product type (part_payment, pay_later, sliced_payment, full_payment, subscription)
• Disbursement status

Example queries:

• "Show me all unshipped orders from last week"
• "Find orders with reference pattern 'SALE2024' that are pending"
• "Search for orders between €100 and €500 from the last 30 days"

Get Order Details

Retrieve comprehensive information for any specific order, including full transaction history and audit trail.

Includes:

• Order status and metadata
• Complete item listings with cart details
• Customer information
• Payment details and totals
• Shipment status and tracking
• Order history and activities
• Invoice information

Example queries:

• "Show me the details for order ORDER-REF-456"
• "What's the current status of order ORDER-REF-XYZ and what items are still unshipped?"

Cancel Order

Cancel orders with proper business justification and automatic audit trail creation.

Features:

• Support for standard cancellation reasons:
  • Customer cancellation
  • Change request
  • Force majeure
  • Out of stock
  • Other (with custom comment)
• Cancellation cost calculation (for eligible products)
• Dry-run mode to preview changes before execution
• Automatic snapshot and audit trail generation

Example queries:

• "Cancel order ORDER-REF-123 with reason 'customer requested cancellation'"
• "What would happen if I cancel order ORDER-REF-456?" (dry-run)

Ship Order Items

Update shipment status for complete orders or individual items with flexible item selection.

Features:

• Ship entire orders or specific items
• Update tracking information
• Move items from unshipped to shipped status
• Dry-run mode to preview available items
• Quantity-based partial shipments

Example queries:

• "Mark items X and Y as shipped for order ORDER-REF-789"
• "Ship all items in order ORDER-REF-321"
• "What items are available to ship in order ORDER-REF-654?" (dry-run)

Update Order Items

Modify order item details, process returns, and update cart information.

Features:

• Update item states (shipped, unshipped, returned)
• Process partial returns
• Modify cart item information
• Dry-run mode to view current item states
• Support for complex item state transitions

Example queries:

• "Process a return for item X in order ORDER-REF-999"
• "Show me all items and their current states in order ORDER-REF-111" (dry-run)
• "Change item Y to returned status in order ORDER-REF-222"