# Vestiarion

> Vestiarion is an MCP server for finance and payments. Read a small business's payment decisions and ledger, and add invoices, from an agent. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API, Web
- **Website:** https://www.vestiarion.xyz/docs/ai-integration/mcp
- **Repository:** https://github.com/duongnq2798/vestiarion
- **MCP Registry name:** io.github.duongnq2798/vestiarion
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-15

## About

Vestiarion's agent pays bills in USDC on Arc, and this MCP server is the window onto its records. Each tool maps to one operation of the Vestiarion API, named in snake case, and returns the same JSON the API does. The exceptions are evidence reads such as a payment's receipt or the monthly close pack, which come back as a digest of the signed file.

Access depends on the workspace API key. A read-only key lets an assistant answer questions like which payments are held and why, whether the ledger is intact, or what is due to contractors. A read-and-write key adds `create_counterparty`, `create_invoice`, `create_milestone` and `create_payee_link`; records added this way are still decided by Vestiarion's own agent, and no tool approves or pays. The docs recommend a separate, revocable key per connected agent.

The server is remote only, over Streamable HTTP at `/api/mcp`, with no session, resources or prompts. The key goes in the Authorization bearer header and is ignored anywhere else, and each call is confined to the key's own workspace.

## Features

- **One tool per API operation:** Tool names follow the API's operation ids and take its parameters.
- **Read-only by default:** A read-only key can explain records but cannot change them; write calls get a 403.
- **Record-adding tools:** With a read-and-write key an agent can create counterparties, invoices, milestones and payee links.
- **Evidence digests:** Payment evidence, receipts and the monthly close pack return a digest of the signed file.
- **Workspace isolation:** Every call reads only the key's own workspace; other workspaces' records answer not_found.
- **Multiple MCP revisions:** The same URL serves the 2026-07-28 revision and the earlier 2025 ones.

## Good for

- Ask which vendor payments are held and why
- Check that the signed ledger is intact before a close
- See what is owed to contractors this month
- Have an assistant add a new invoice for the payment agent to review
- Create a payee link without leaving the chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http vestiarion https://www.vestiarion.xyz/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.vestiarion.xyz/api/mcp
```

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

```json
{
  "mcpServers": {
    "vestiarion": {
      "url": "https://www.vestiarion.xyz/api/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "vestiarion": {
      "type": "http",
      "url": "https://www.vestiarion.xyz/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vestiarion": {
      "serverUrl": "https://www.vestiarion.xyz/api/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://www.vestiarion.xyz/api/mcp
```

Enter a Name (for example "Vestiarion"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

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

```json
{
  "mcpServers": {
    "vestiarion": {
      "type": "http",
      "url": "https://www.vestiarion.xyz/api/mcp"
    }
  }
}
```

## Tools

- `create_counterparty`: Add a counterparty (needs a read-and-write key).
- `create_invoice`: Add an invoice (needs a read-and-write key).
- `create_milestone`: Add a milestone (needs a read-and-write key).
- `create_payee_link`: Make a payee link (needs a read-and-write key).
- `get_counterparty`: Read a counterparty in the key's own workspace.

## FAQ

### Can an agent approve or pay through this server?

No. The docs say no tool verifies work, approves or pays; added records are decided by Vestiarion's agent as usual.

### Which key should I use?

Start with a read-only key. Use a read-and-write key only for agents that must add records, and give each its own named key.

### Does it keep sessions?

No. The server is stateless, so clients send every message as a POST; GET and DELETE answer 405.

### What happens with a bad key?

A missing, unknown or revoked key answers 401, and a key without read scope answers 403.

### How do I add Vestiarion to Claude Code?

Run this command in your terminal: claude mcp add --transport http vestiarion https://www.vestiarion.xyz/api/mcp

### What are the best alternatives to Vestiarion?

The closest alternatives to Vestiarion are Vybe Pay MCP, Roundhouse, Averray, MCP Holded and Bvcc Agent Wallet.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Vybe Pay MCP](https://ai-powered.com/mcp/vybe-pay-mcp): Vybe Pay MCP is a freemium MCP server for finance and payments.
- [Roundhouse](https://ai-powered.com/mcp/roundhouse): Roundhouse is a freemium MCP server for analytics and data.
- [Averray](https://ai-powered.com/mcp/averray): Averray is a paid MCP server for finance and payments.
- [MCP Holded](https://ai-powered.com/mcp/mcp-holded-2): MCP Holded is an open-source MCP server for finance and payments.
- [Bvcc Agent Wallet](https://ai-powered.com/mcp/bvcc-agent-wallet): Bvcc Agent Wallet is an MCP server for finance and payments.
- [brick.blue](https://ai-powered.com/mcp/brick-blue): brick.blue is a freemium MCP server for developer tools.
- [Sevdesk MCP](https://ai-powered.com/mcp/sevdesk-mcp): Sevdesk MCP is a free MCP server for finance and payments.
- [AgentLedger](https://ai-powered.com/mcp/agentledger): AgentLedger is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/vestiarion
