# Tolca

> Tolca is a freemium MCP server for finance and payments. Check x402 payment requests and Québec contractors before your agent pays. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://tolca.tonbot.ca
- **Repository:** https://github.com/yayabough/tolca
- **MCP Registry name:** io.github.yayabough/tolca
- **Categories:** finance and payments, security
- **Listing updated:** 2026-11-15

## About

Tolca screens before money moves. Hand it the 402 payment request an agent just received and it returns allow, review or block with a risk score, reasons and a signed receipt, covering sanctioned wallets (US SDN list), look-alike tokens, inflated prices against the x402 Bazaar catalogue, swapped addresses, wrong networks and, if you pass the seller's name, sanctions screening in the US, UK, EU and Canada.

The README adds Québec-focused checks: contractor safety (RBQ licence, public-contract bans, environmental penalties, recent contracts), a quick licence yes or no, business verification against sanctions lists and company registries, a live company profile and a web search with page text. Results are deterministic JSON with sources and a hash; only the company profile uses an AI model.

A free public MCP endpoint (read-only, daily quota, no account) sits beside a paid x402 endpoint. Payment check costs $0.01 in USDC on Base or Solana.

## Features

- **Payment request check:** Verdict plus signed receipt valid for 10 minutes.
- **Wallet and token screening:** Compares addresses with sanctions and the official USDC contract.
- **Québec contractor check:** RBQ licence, bans, penalties and public contracts.
- **Business verification:** Sanctions lists and company registries.
- **Web search reader:** Ten results plus text of top pages.
- **Free public endpoint:** Read-only access with a daily quota.

## Good for

- Vet an x402 seller before an agent signs
- Check a Québec contractor's licence
- Screen a supplier against sanctions lists
- Wrap payments with a safety check via tolca-safe-pay

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tolca https://tolca.tonbot.ca/mcp/public
```

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

```sh
https://tolca.tonbot.ca/mcp/public
```

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

```json
{
  "mcpServers": {
    "tolca": {
      "url": "https://tolca.tonbot.ca/mcp/public"
    }
  }
}
```

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

```json
{
  "servers": {
    "tolca": {
      "type": "http",
      "url": "https://tolca.tonbot.ca/mcp/public"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tolca": {
      "serverUrl": "https://tolca.tonbot.ca/mcp/public"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tolca": {
      "type": "http",
      "url": "https://tolca.tonbot.ca/mcp/public"
    }
  }
}
```

## Tools

- `payment_check`: Checks an x402 payment request and returns allow, review or block.
- `qc_contractor_check`: Checks a Québec contractor's licence, bans, penalties and contracts.
- `qc_licence`: Checks whether a contractor holds an active RBQ licence.
- `business_verification`: Verifies a company against sanctions lists and registries.
- `company_profile`: Reads a company profile from its own website plus screening.
- `web_search`: Returns search results with page text.

## FAQ

### How much does a payment check cost?

$0.01 in USDC on Base or Solana.

### Do I need an account?

No account or API key.

### Is there a free option?

Yes, a public read-only MCP endpoint with a daily quota.

### Does it use an LLM?

Only the company profile summary; checks are deterministic.

### Is Tolca free?

Tolca has a free plan, with paid plans for more usage or features.

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

Run this command in your terminal: claude mcp add --transport http tolca https://tolca.tonbot.ca/mcp/public

### What are the best alternatives to Tolca?

The closest alternatives to Tolca 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/tolca-2
