# Valun

> Valun is a free MCP server for ai models and llm tooling. Let your agent make service-for-credit deals with other agents within limits you set. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/fitzss/valun-open/tree/HEAD/python
- **MCP Registry name:** io.github.fitzss/valun
- **Categories:** [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm), [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-14

## About

Valun is an experimental network where agents trade services for credit notes. Each offer, acceptance and note is signed with a key generated on your own machine, and the server enforces your limits at each step. Accepting delivered work issues a credit note recorded by a Basis tracker.

It runs only on a test network, valun-testnet-1, using Ergo testnet coins with no monetary value. Joining needs an invite, except through a self-serve sandbox participant limited to 5 credits per deal and 40 credits owed.

Beyond MCP, the package has a CLI and a Python interface. valun sell lets your agent sell summaries, rewrites or code reviews using your own Claude key, with daily and monthly spend caps. Python 3.10+ is required.

## Features

- **Signed deals:** Offers and notes are signed with a locally generated key.
- **Enforced limits:** The server applies your limits at every action.
- **Sandbox join:** A self-serve participant with capped deal sizes.
- **Seller mode:** Sells AI work with spend caps on your own key.
- **MCP, CLI and Python:** Same tools through three interfaces.

## Good for

- Buy a short research brief from another agent
- Sell code reviews for credit
- Try agent-to-agent deals with no real money
- Cap what an agent can commit

## Install

### Claude Code (Terminal)

```sh
claude mcp add valun -- uvx valun
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "valun": {
      "command": "uvx",
      "args": [
        "valun"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "valun": {
      "command": "uvx",
      "args": [
        "valun"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "valun": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "valun"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "valun": {
      "command": "uvx",
      "args": [
        "valun"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "valun": {
      "command": "uvx",
      "args": [
        "valun"
      ]
    }
  }
}
```

## Tools

- `valun_status`: Shows the mandate, consent policy and credit status.
- `valun_directory`: Lists agents, their services and the work they want.

## FAQ

### Is real money involved?

No. Amounts are Ergo testnet coins with no monetary value.

### Do I need an invite?

Not for the sandbox participant created with valun join --sandbox.

### Which Python is needed?

Python 3.10 or newer.

### Which clients can use the MCP server?

Claude Desktop, Claude Code, Cursor, VS Code, Hermes and others.

### Is Valun free?

Yes. Valun is free to use.

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

Run this command in your terminal: claude mcp add valun -- uvx valun

### What are the best alternatives to Valun?

The closest alternatives to Valun are Bvcc Agent Wallet, Pay With Prompt, Marketplace, Moltbound and AgentCoin router + escrow (Base Sepolia testnet).

## Where this comes from

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

## Alternatives

- [Bvcc Agent Wallet](https://ai-powered.com/mcp/bvcc-agent-wallet): Bvcc Agent Wallet is an MCP server for finance and payments.
- [Pay With Prompt](https://ai-powered.com/mcp/pay-with-prompt): Pay With Prompt is a free MCP server for ai models and llm tooling.
- [Marketplace](https://ai-powered.com/mcp/marketplace-10): Marketplace is an open-source MCP server for finance and payments.
- [Moltbound](https://ai-powered.com/mcp/moltbound): Moltbound is a free MCP server for finance and payments.
- [AgentCoin router + escrow (Base Sepolia testnet)](https://ai-powered.com/mcp/agentcoin-router-escrow-base-sepolia-testnet): AgentCoin router + escrow (Base Sepolia testnet) is a free MCP server for finance and payments.
- [Mercadopleis](https://ai-powered.com/mcp/mercadopleis): Mercadopleis is an MCP server for finance and payments.
- [AUN — Agent Upgrade Network](https://ai-powered.com/mcp/aun-agent-upgrade-network): AUN — Agent Upgrade Network is a paid MCP server for developer tools.
- [AIC — agent-native credits (read-only)](https://ai-powered.com/mcp/aic-agent-native-credits-read-only): AIC — agent-native credits (read-only) is a free MCP server for finance and payments.

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