# @asterpay/mcp-server

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/timolein74/asterpay-mcp-server  
**npm Downloads (last month):** 144  
**Views:** 9  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/-asterpay-mcp-server

## Description
EUR settlement for AI agents via x402 protocol. Market data, AI tools, crypto analytics — pay-per-call in USDC on Base. SEPA Instant EUR off-ramp.

## Tools
Capabilities this server exposes over MCP:

- **list_products** — List all products available from the merchant. Returns names, prices in EUR, descriptions, availability, and variants.
- **get_product** — Get detailed information about a specific product by its ID. Use list_products first to find available product IDs.
- **check_availability** — Check if a specific product is currently in stock. Returns availability status, stock quantity, and current price.
- **get_business_info** — Get business information for the merchant: operating hours, contact details, delivery zones and fees, return policy, and accepted payment methods.
- **place_order** — Place an order with a merchant. Creates an intent, then submits the order. Returns x402 payment details that your agent's x402 client needs to execute. In mock mode, simulates a successful order.
- **get_order_status** — Check the status of an existing order. Returns status (pending, confirmed, rejected, expired), payment info, and items.
- **get_x402_payment_details** — Get x402 payment details for an order: facilitator endpoint, USDC amount, network, and payment header. Your agent needs an x402 client (e.g. @x402/axios) to execute the actual payment.
- **set_budget** — Activate a prepaid budget (AsterPay /budget) so the agent can spend on paid x402 APIs with a hard cap. Three modes: (1) pass an existing budget token (bud_...) to activate it; (2) pass amount_usd + tx_hash + wallet after your HUMAN sent the USDC, to create a new budget; (3) pass nothing to get funding instructions. An agent cannot grant itself money — a human must make the one-time USDC transfer (1-500 USDC on Base). Credited 1:1, no platform fee. Funding wallet is sanctions-screened (Chainalysis). No API key needed.
- **get_budget_status** — Check the prepaid /budget balance: remaining USD, total spent, recent calls with per-call prices. Use BEFORE expensive calls to spend gracefully. FREE, no API key needed.

## Claude Desktop Quick Installation
Install path inferred — verify against the README before running it. Uses `npx` (confidence: medium):

```json
"mcpServers": {
  "mcp-server": {
    "command": "npx",
    "args": ["-y","@asterpay/mcp-server"]
  }
}
```

## Documentation

## What @asterpay/mcp-server MCP server does

The @asterpay/mcp-server MCP server gives an agent a merchant-facing workflow over MCP. It can retrieve a product catalog, inspect individual products, check inventory, read business policies, create orders, and retrieve order status. Product responses include names, EUR prices, descriptions, availability, and variants. Business information can include operating hours, contact details, delivery zones and fees, return policies, and accepted payment methods.

The server also connects order workflows to the x402 payment protocol. After an order intent is created, the agent can retrieve the facilitator endpoint, USDC amount, network, and payment header needed to execute payment. This makes the server relevant to agents that buy products or call paid APIs rather than only read merchant data.

## How it works

A typical product workflow starts with `list_products`, followed by `get_product` or `check_availability` for a selected product ID. `place_order` creates an intent and submits the order; its response includes x402 payment details for the agent’s payment client. `get_order_status` can then report whether the order is pending, confirmed, rejected, or expired, along with payment information and items.

For paid x402 API calls, `set_budget` activates an AsterPay prepaid budget. An agent can supply an existing `bud_...` token, or a human can first send between 1 and 500 USDC on Base and provide the transaction hash and wallet. Calling the tool without those values returns funding instructions. `get_budget_status` reports the remaining balance, total spending, and recent calls with per-call prices.

## Tools and capabilities

- `list_products`: Retrieves all products offered by a merchant.
- `get_product`: Returns detailed information for a product ID.
- `check_availability`: Reports stock status, quantity, and current price.
- `get_business_info`: Retrieves merchant operations, delivery, returns, and payment information.
- `place_order`: Creates and submits an order, returning x402 payment data.
- `get_order_status`: Checks the current state and payment details of an order.
- `get_x402_payment_details`: Returns the payment data required by an x402 client.
- `set_budget`: Activates an existing prepaid budget or helps create one after human funding.
- `get_budget_status`: Shows available funds and recent paid calls.

## Limitations and notes

The @asterpay/mcp-server MCP server does not let an agent grant itself money. New budget funding requires a one-time human USDC transfer on Base, and the funding wallet is sanctions-screened by Chainalysis. The budget is credited 1:1 with no platform fee according to the supplied material.

The server supplies x402 payment details but does not itself execute the payment. An agent needs a compatible x402 client, such as `@x402/axios`, to submit the actual payment. Product IDs should be discovered with `list_products` before calling product-specific tools. In mock mode, `place_order` simulates a successful order. The available material does not specify installation commands, required server environment variables, supported desktop clients, or a software license.

_Full upstream README: https://allmcps.com/mcp/-asterpay-mcp-server/readme_