# shabaaspay

ShaBaas Pay MCP lets AI agents securely create PayTo agreements, initiate payments, and check statuses via structured tools. Authenticate with your ShaBaas Pay API key and control tool access from th…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add shabaaspay/payments

# Browse available tools
npx -y @smithery/cli@latest tool list shabaaspay/payments

# Get full schema for a tool
npx -y @smithery/cli@latest tool get shabaaspay/payments get_payment_agreement

# Call a tool
npx -y @smithery/cli@latest tool call shabaaspay/payments get_payment_agreement '{}'
```

## Direct MCP Connection

Endpoint: `https://payments--shabaaspay.run.tools`

**Required config:**
- `apiKey` (header) — ShaBaas Pay API Key

## Tools (5)

- `get_payment_agreement` — Retrieve payment agreement details with AI insights
- `create_payment_agreement` — Create a new payment agreement
- `initiate_payment` — Initiate a payment against an agreement
- `get_payment_initiation` — Retrieve payment initiation by ID
- `get_auth_token` — Get ShaBaas API authorization token

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get shabaaspay/payments <tool-name>
```

## Prompts (2)

- `create_payto_agreement` (payer_name, pay_id, maximum_amount, frequency) — Draft parameters for a new PayTo agreement, then call create_payment_agreement with validated fields.
- `check_payment_status` (payment_agreement_id, payment_initiation_id) — Given an agreement or initiation ID, retrieve status and summarize next actions for the user.
