# Paypilot Ach Returns MCP

> Paypilot Ach Returns MCP is an open-source MCP server for finance and payments. Read-only lookup table of 17 ACH return codes mapped to five decisions. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/ivansflowgit/paypilot
- **MCP Registry name:** io.github.IvanSFlowGit/paypilot-ach-returns-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

This local server answers one narrow question: given an ACH return code, what should happen next? The registry entry describes a read-only decision table covering 17 codes and 5 decisions, and each answer shows the rule that produced it. Nothing is sent or changed.

It is published to PyPI as paypilot-ach-returns-mcp and runs over stdio. It comes from the PayPilot repository, a worked example of an agent that handles failed subscription payments with a fixed rules table, records which rule fired, and only sends email after a person approves. That project's README stresses that a deterministic table, not a model, picks the action.

A developer building payment-recovery or bank-return handling can let an assistant consult the table instead of improvising a policy.

## Features

- **ACH return code table:** Covers 17 return codes mapped to five possible decisions.
- **Rule shown:** Each answer includes the rule that applied.
- **Read-only:** The server only looks values up and does not act on accounts.
- **Stdio transport:** Runs locally as a Python package from PyPI.

## Good for

- Decide how to handle a returned ACH payment
- Explain why a return code leads to a given action
- Give a billing-recovery agent a fixed policy to consult
- Audit which rule applied to a past return

## Install

### Claude Code (Terminal)

```sh
claude mcp add paypilot-ach-returns-mcp -- uvx paypilot-ach-returns-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "paypilot-ach-returns-mcp": {
      "command": "uvx",
      "args": [
        "paypilot-ach-returns-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "paypilot-ach-returns-mcp": {
      "command": "uvx",
      "args": [
        "paypilot-ach-returns-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "paypilot-ach-returns-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "paypilot-ach-returns-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "paypilot-ach-returns-mcp": {
      "command": "uvx",
      "args": [
        "paypilot-ach-returns-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "paypilot-ach-returns-mcp": {
      "command": "uvx",
      "args": [
        "paypilot-ach-returns-mcp"
      ]
    }
  }
}
```

## FAQ

### Does it move money or send messages?

No. The registry describes it as a read-only decision table.

### How is it installed?

As the PyPI package paypilot-ach-returns-mcp, version 0.1.1, over stdio.

### Does it need credentials?

No environment variables are listed.

### Is Paypilot Ach Returns MCP free?

Yes. Paypilot Ach Returns MCP is open source, so you can use and self-host it for free.

### How do I add Paypilot Ach Returns MCP to Claude Code?

Run this command in your terminal: claude mcp add paypilot-ach-returns-mcp -- uvx paypilot-ach-returns-mcp

### What are the best alternatives to Paypilot Ach Returns MCP?

The closest alternatives to Paypilot Ach Returns MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Crypto Feeds and Crypto Fng.

## Where this comes from

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

## Alternatives

- [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.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.
- [Zovo LEI Lookup](https://ai-powered.com/mcp/zovo-lei-lookup): Zovo LEI Lookup is an MCP server for finance and payments.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/paypilot-ach-returns-mcp
