Taggun MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.23.4Updated Nov 7, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFiles & StorageData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted Taggun server that lets an assistant OCR receipts from a URL or base64 file and read receipt-validation campaigns and account reference data.

What you can do
  • Scan receipts and invoices from a public URL or base64 data and get structured fields such as merchant, date, tax and totals
  • Validate a receipt against a stored campaign's rules
  • List validation campaigns and read one campaign's rules (dates, merchants, products, fraud checks)
  • Export account reference data as CSV: product categories, known merchants, product codes
  • Check monthly usage and manage the subscription (upgrade, cancel) or file a feature request
When to use it
Useful when you want an assistant to pull structured data out of receipt or invoice images, or to check receipts against Taggun validation campaigns, without writing your own Taggun integration.
Requirements
Remote MCP endpoint; no local install. Sign-in is via OAuth, and the login page asks for your own Taggun credentials. Do not add an Authorization header or API key to the client config. A Taggun account with the Campaign Validation feature is needed for campaign tools.
Before you install
Scan tools are billed per scan against your Taggun quota and plan, even when validation fails, and are never retried automatically. Meta tools can start a paid subscription through a Stripe Checkout link or cancel it, with no refund for the current period. The server's own free tier is 50 tool calls per month; paid plans are billed separately. Receipt content is sent to Taggun and this hosted server.

Installation

In SourceWeft

  1. Open Taggun MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Ftaggun/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Taggun MCP by usefulapi

Use Taggun from Claude, Cursor, or any MCP client — receipt OCR from a URL or base64 file and receipt-validation campaigns. Hosted, no local install: connect with your own Taggun credentials.

Live endpoint: https://taggun.usefulapi.io/mcp · Homepage: https://usefulapi.io/taggun

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://taggun.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http taggun https://taggun.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "taggun": {      "url": "https://taggun.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Taggun credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/taggun/

Tools

ToolTypeWhat it does
taggun_scan_receipt_urlwriteScan a receipt or invoice from a URL
taggun_scan_receipt_base64writeScan a receipt or invoice from base64 data
taggun_validate_receipt_campaign_urlwriteValidate a receipt against a stored campaign
taggun_list_campaignsreadList validation campaigns
taggun_get_campaignreadGet a validation campaign's rules
taggun_export_reference_datareadExport account reference data (CSV)
taggun_usage_statusmetaUsage status (free-tier meter)
taggun_request_featuremetaRequest a missing feature
taggun_upgrademetaUpgrade to Pro or Pro+
taggun_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with taggun_upgrade (it returns a Stripe Checkout link). Cancel any time with taggun_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running taggun_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Taggun.

Source: servers/taggun/README.md at commit 4046075

Tools

6

taggun_scan_receipt_url

Scan a receipt or invoice from a 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, GIF, HEIF/HEIC or PDF up to 5 pages, max 20 MiB). The URL must be a public host name: no IP addresses, localhost, internal names, credentials or non-default ports. POST /api/receipt/v1/{simple|verbose}/url.

Parametersurlrequiredneardetaillanguagekeep_storedextract_timeextract_line_itemsignore_merchant_name

taggun_scan_receipt_base64

Scan a receipt or invoice from base64 data

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 characters, about 1.5 MB of file; for larger files use taggun_scan_receipt_url). POST /api/receipt/v1/{simple|verbose}/encoded.

Parametersneardetailfilenamelanguagekeep_storedcontent_typerequiredextract_timeimage_base64requiredextract_line_itemsignore_merchant_name

taggun_validate_receipt_campaign_url

Validate a receipt against a stored campaign

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, balance owing, fraud checks). Returns pass/fail with reasons. Needs the Campaign Validation feature on your Taggun plan; use taggun_list_campaigns for the ids. Same URL rules as taggun_scan_receipt_url. POST /api/validation/v1/campaign/receipt-validation/url.

Parametersurlrequirednearlanguagecampaign_idrequiredkeep_stored

taggun_list_campaigns

List validation 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.

Takes no parameters.

taggun_get_campaign

Get a validation campaign's rules

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}.

Parameterscampaign_idrequired

taggun_export_reference_data

Export account reference data (CSV)

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.

Parameterskindrequired

Version history

19
  1. v1.23.4LatestNov 7, 2026
  2. v1.22.3Nov 5, 2026
  3. v1.22.2Nov 5, 2026
  4. v1.22.1Nov 4, 2026
  5. v1.22.0Nov 3, 2026
  6. v1.21.1Nov 3, 2026
  7. v1.20.0Nov 1, 2026
  8. v1.18.0Oct 31, 2026
  9. v1.17.0Oct 31, 2026
  10. v1.16.2Oct 30, 2026
  11. v1.16.0Oct 30, 2026
  12. v1.11.0Oct 26, 2026
  13. v1.8.3Oct 25, 2026
  14. v1.8.0Oct 25, 2026
  15. v1.7.0Oct 24, 2026
  16. v1.4.0Oct 23, 2026
  17. v1.3.4Oct 22, 2026
  18. v1.3.3Oct 21, 2026
  19. v1.0.0Oct 12, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations