# Taggun MCP by usefulapi

> Taggun MCP by usefulapi is an MCP server. Scan receipts with Taggun OCR from a URL or file and read receipt-validation campaigns. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/taggun/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/taggun
- **MCP Registry name:** io.usefulapi/taggun
- **Listing updated:** 2026-11-13

## About

Scan receipts with Taggun OCR from a URL or file and read receipt-validation campaigns.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http taggun https://taggun.usefulapi.io/mcp
```

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

```sh
https://taggun.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "taggun": {
      "url": "https://taggun.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "taggun": {
      "type": "http",
      "url": "https://taggun.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "taggun": {
      "serverUrl": "https://taggun.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "taggun": {
      "type": "http",
      "url": "https://taggun.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `taggun_scan_receipt_url`: WRITE: this scan counts against YOUR Taggun quota and plan (free for the first 30 days or 1,000 scans, then billed per scan by Taggun), even if the receipt fails validation; it is never retried automatically. Document content is not logged by this server. Extract structured data (merchant, date, total, tax, and in verbose mode line items) from a receipt or invoice at a public https URL (JPEG, PNG,
- `taggun_scan_receipt_base64`: WRITE: this scan counts against YOUR Taggun quota and plan (free for the first 30 days or 1,000 scans, then billed per scan by Taggun), even if the receipt fails validation; it is never retried automatically. Document content is not logged by this server. Extract structured data from a receipt or invoice sent as base64 (JPEG, PNG, GIF, HEIF/HEIC or PDF; the base64 text is capped at 2,000,000 chara
- `taggun_validate_receipt_campaign_url`: WRITE: this scan counts against YOUR Taggun quota and plan (free for the first 30 days or 1,000 scans, then billed per scan by Taggun), even if the receipt fails validation; it is never retried automatically. Document content is not logged by this server. Scan a receipt at a public https URL and check it against the rules of a campaign stored on your Taggun account (dates, merchants, products, bal
- `taggun_list_campaigns`: List the ids of the receipt-validation campaigns stored on your Taggun account (an empty list is normal). Does not use a scan. Needs the Campaign Validation feature; without it Taggun answers that the feature must be enabled. GET /api/validation/v1/campaign/settings/list.
- `taggun_get_campaign`: The stored validation rules of one campaign (dates, merchants, products, fraud checks, SmartValidate prompts). Does not use a scan. GET /api/validation/v1/campaign/settings/{campaignId}.
- `taggun_export_reference_data`: Read the reference data stored on your Taggun account as CSV: product_categories (the category taxonomy), known_merchants (merchant names and locations used for matching) or product_codes (expected product codes). Read-only; does not use a scan. The text is cut at 40,000 characters. GET /api/account/v1/{product-categories|known-merchants|known-product-codes}/export.

## FAQ

### How do I add Taggun MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http taggun https://taggun.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/taggun-mcp-by-usefulapi
