# Veyline by Payload

> Veyline by Payload is a freemium MCP server for finance and payments. Check an agent's payment entitlement and get signed spending-policy preflights. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, self-hosted, API
- **Website:** https://payloadhq.github.io/veyline.html
- **Repository:** https://github.com/payloadhq/veyline-mcp
- **MCP Registry name:** io.github.payload-tools/veyline-mcp
- **Categories:** finance and payments, security
- **Listing updated:** 2026-11-15

## About

Veyline answers one question before an agent pays: is this payment allowed under policy? This stdio server wraps three of its skills on the Payload rail. Two are reads, reporting your organisation's entitlement and tier and its quota and usage. The third requests a signed, short-lived preflight for a proposed payment, which needs the original x402 quote from the seller and fails closed if the quote is incomplete.

A preflight checks spending limits, permitted recipients and organisation policy, then returns an expiring authorisation bound to that payment intent. No funds move. Your own wallet or signer still makes the payment, and Veyline never holds funds or signs for you. The README is plain that it cannot guarantee external networks or counterparties will not fail.

It runs on Node.js with no dependencies, installed as an MCPB bundle or from source, using your own rail API key. A free key with 1,000 operations a month is offered for evaluation. The preflight example uses the network eip155:8453.

## Features

- **Entitlement read:** Report the organisation's Veyline entitlement and tier without authorising a payment.
- **Usage read:** Report quota and usage without changing policy.
- **Signed preflight:** Request a short-lived, policy-enforced authorisation for a payment; no funds are transferred.
- **Fail-closed quotes:** Preflights with incomplete x402 quote details are refused.
- **Non-custodial design:** Your own wallet or signer executes payment; Veyline never holds funds.
- **MCPB or source install:** Install the v1.1.0 bundle or run from source on Node.js.

## Good for

- Put a spending-policy gate in front of an agent's x402 payments
- Check remaining quota before an agent starts a paid task
- Confirm a payment recipient and amount fit organisation limits
- Keep the signed preflight alongside the payment it authorised

## Install

### Claude Code (Terminal)

```sh
claude mcp add veyline-mcp -- npx -y https://github.com/Payloadhq/veyline-mcp/releases/download/v1.1.0/veyline.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "veyline-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Payloadhq/veyline-mcp/releases/download/v1.1.0/veyline.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "veyline-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Payloadhq/veyline-mcp/releases/download/v1.1.0/veyline.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "veyline-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Payloadhq/veyline-mcp/releases/download/v1.1.0/veyline.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "veyline-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Payloadhq/veyline-mcp/releases/download/v1.1.0/veyline.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "veyline-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Payloadhq/veyline-mcp/releases/download/v1.1.0/veyline.mcpb"
      ]
    }
  }
}
```

## Tools

- `veyline_status`: Read the organisation's Veyline entitlement and tier.
- `veyline_usage`: Read the organisation's quota and usage.
- `veyline_preflight`: Request a signed, short-lived, policy-enforced payment preflight; no funds are transferred.

## FAQ

### Does it move money?

No. Preflight returns a signed authorisation; the customer's own wallet or signer makes any payment.

### What does a preflight need?

The authoritative x402 quote and fields such as protocol, provider, action, network, asset, amount in cents, recipient, request hash and quote ID.

### How do I try it?

Get a free Payload rail API key, which the README says includes 1,000 operations a month.

### Which transport does it use?

stdio.

### Is Veyline by Payload free?

Veyline by Payload has a free plan, with paid plans for more usage or features.

### How do I add Veyline by Payload to Claude Code?

Run this command in your terminal: claude mcp add veyline-mcp -- npx -y https://github.com/Payloadhq/veyline-mcp/releases/download/v1.1.0/veyline.mcpb

### What are the best alternatives to Veyline by Payload?

The closest alternatives to Veyline by Payload are REA, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Agent Roast and Midplane.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/veyline-by-payload
