Juspay

You can deploy and use the Juspay MCP server to enable AI agents and tools to interact with Juspay core payment processing and merchant dashboard features. This MCP server translates natural language requests into authenticated API calls, letting you manage orders, payments, customers, gateways, reports, and more through a consistent MCP interface.

How to use

You access the Juspay MCP server through MCP clients or integrations that know how to talk MCP. You can run a Core API server to interact with Juspay’s core payment workflows or run a Dashboard API server to manage merchant configuration, gateways, reporting, and users. For local development, you can run a stdio (local) MCP server via Docker, or run the server directly in HTTP/stdio modes. Start a Core instance to handle payment processing tasks and a separate Dashboard instance to handle merchant dashboard tasks if you need both capabilities.

How to install

Prerequisites: ensure you have Nix installed and Python available in your development environment. You will also need Docker if you plan to run the MCP servers as containers.

Step 1: Clone the project and enter the directory.

Step 2: Set up the development environment with Nix.

Step 3: Start the Core MCP server in HTTP mode or run the stdio variant for local development.

Step 4: If you need the Dashboard MCP server, run the corresponding stdio or HTTP configuration as described in the configuration steps.

Configuration

Configure credentials and environment to expose the desired MCP tools. The following environment variables are used to authorize and select the instrumented APIs:

Troubleshooting

If you encounter authentication failures, verify that your API keys and tokens are correct and that you’re using the appropriate sandbox or production environment. If you see request validation errors, check that required fields are present and properly formatted. For connection issues, confirm network access to Juspay endpoints and adjust firewall rules if needed.

Available tools

create_order_juspay

Creates a new order in Juspay payment system.

update_order_juspay

Updates an existing Juspay order with new details.

order_status_api_juspay

Retrieves the current status of a Juspay order by order_id.

order_fulfillment_sync_juspay

Updates the fulfillment status for a Juspay order.

session_api_juspay

Creates a new Juspay session for a given order.

create_txn_juspay

Creates an order and processes payment in a single call.

create_moto_txn_juspay

Creates an order with MOTO authentication.

create_refund_juspay

Initiates a refund for a specific Juspay order by order_id.

create_txn_refund_juspay

Initiates a refund based on a transaction ID.

create_customer_juspay

Creates a new customer in Juspay.

get_customer_juspay

Retrieves customer details by Juspay customer ID.

update_customer_juspay

Updates an existing Juspay customer.

add_card_juspay

Adds a new card to a Juspay customer.

list_cards_juspay

Lists all stored cards for a Juspay customer.

delete_card_juspay

Deletes a saved card from Juspay.

update_card_juspay

Updates details for a saved card.

get_card_info_juspay

Retrieves information about a specific card BIN.

get_bin_list_juspay

Retrieves eligible BINs for a given authentication type.

get_saved_payment_methods

Retrieves a customer's saved payment methods.

upi_collect

Creates a UPI Collect transaction.

verify_vpa

Verifies a UPI VPA is valid.

upi_intent

Creates a UPI Intent transaction.

list_offers_juspay

Lists available offers for an order with optional coupon.

get_offer_order_status_juspay

Retrieves offer details for an order.

list_wallets

Fetches wallets linked to a customer.

juspay_list_configured_gateway

Gets all configured gateways for the merchant.

juspay_get_gateway_scheme

Provides detailed config for a gateway.

juspay_get_gateway_details

Returns detailed information about a configured gateway.

juspay_list_gateway_scheme

Returns a list of all available gateways.

juspay_gateway_downtime

Retrieves gateway downtime information.

juspay_get_merchant_gateways_pm_details

Fetches gateways and their supported payment methods.

juspay_report_details

Returns detailed information for a specific report ID.

juspay_list_report

Lists all reports configured by the merchant.

juspay_list_orders_v4

Retrieves orders within a time range (dashboard perspective).

juspay_get_order_details

Returns details for a given order ID (dashboard perspective).

juspay_list_payment_links_v1

Retrieves payment links created within a time range.

juspay_get_user

Fetches details for a specific user by user ID.

juspay_list_users_v2

Retrieves a list of users for a merchant.

juspay_get_conflict_settings

Retrieves conflict settings for payment processing.

juspay_get_general_settings

Retrieves general merchant settings.

juspay_get_mandate_settings

Retrieves mandate-related settings for recurring payments.

juspay_get_priority_logic_settings

Fetches all configured priority logic rules.

juspay_get_routing_settings

Provides details of routing thresholds based on success rates.

juspay_get_webhook_settings

Retrieves webhook configuration for the merchant.

juspay_list_surcharge_rules

Returns all configured surcharge rules.

q_api

Generic Query API for dashboard data domains.