# Vaaya

Vaaya lets an agent call paid APIs from a shared balance with a per-call spending cap. It also supports purchases of tokenized stocks using prepaid funds.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 44
- Author: vaaya-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/vaaya-ai/vaaya-mcp
- Updated: 2026-09-13
- HTML: https://affpapa.org/en/nevibecode/mcp/vaaya

## What it does

Vaaya connects an agent to paid services for search, data collection, research, and compute. The agent can request a priced plan, then set a maximum cost for each call; requests over that limit are refused before reaching the provider. Charges apply only to successful calls. The cap is part of the request, so the agent must set it each time.

In Claude Code, connect the remote server over HTTP or run it through `npx`. The first use opens a browser authorization flow. A separate `stocks` tool lists supported tickers, checks buying power, and places orders for tokenized stocks on Base. Purchases require prepaid funds and user authorization; these are not direct brokerage shares.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://vaaya.ai/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://vaaya.ai/mcp
```

2. **Platform CLI**
```bash
claude mcp add vaaya -- npx -y @vaaya/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add vaaya --url https://vaaya.ai/mcp
```

2. **Platform CLI**
```bash
codex mcp add vaaya -- npx -y @vaaya/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vaaya": {
            "url": "https://vaaya.ai/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vaaya": {
            "command": "npx",
            "args": [
                "-y",
                "@vaaya/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "vaaya": {
            "type": "http",
            "url": "https://vaaya.ai/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "vaaya": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@vaaya/mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http vaaya https://vaaya.ai/mcp
```

2. **Platform CLI**
```bash
gemini mcp add vaaya npx -y @vaaya/mcp
```

## When to use it
- call paid APIs with a per-request spending limit
- search the web and retrieve data through paid services
- check supported tokenized stocks and available buying power
- place a stock order and check its status

## Example prompts
- Search for this topic using a paid API, with a maximum call cost of 50 cents.
- Show the supported stocks and check my account's buying power.
- With my approval, buy a tokenized stock for the specified amount and check the order status.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md