{
  "info": {
    "name": "Taggun — mcp.ai",
    "description": "REST API for the Taggun MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/taggun",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "taggun_add_merchant_name",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/add/merchant/name",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "add",
            "merchant",
            "name"
          ]
        },
        "description": "Tool to add a merchant name keyword to your account's model for predicting merchant names. Use when you want to improve merchant name recognition by training the model with specific merchant names. Ch",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"merchantName\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taggun_export_known_merchants",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/export/known/merchants",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "export",
            "known",
            "merchants"
          ]
        },
        "description": "Export the complete list of known merchants used for merchant name normalization in Taggun. Returns CSV data with merchant details including location IDs, names, addresses, and coordinates. Use this w",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taggun_export_known_product_codes",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/export/known/product/codes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "export",
            "known",
            "product",
            "codes"
          ]
        },
        "description": "Export the complete list of known product codes used for product normalization and matching in Taggun. Returns CSV data with product code information. Use this when you need to retrieve the full produ",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taggun_export_product_categories",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/export/product/categories",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "export",
            "product",
            "categories"
          ]
        },
        "description": "Export a list of product categories and descriptions used for product categorization in CSV format. Returns CSV data with product category information for analysis or synchronization purposes. Use thi",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taggun_generate_merchants_csv",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/generate/merchants/csv",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "generate",
            "merchants",
            "csv"
          ]
        },
        "description": "Generate a CSV file with mock merchant data for testing purposes. Creates a temporary CSV file with the specified number of merchant rows, including fields like name, alias, address, coordinates, cont",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"row_count\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taggun_import_known_merchants",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/import/known/merchants",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "import",
            "known",
            "merchants"
          ]
        },
        "description": "Import a list of merchant names and addresses to normalize and match in CSV or TSV format. Use this when you need to bulk upload merchant data for name normalization and matching. File must be less th",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"file\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taggun_import_known_product_codes",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/import/known/product/codes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "import",
            "known",
            "product",
            "codes"
          ]
        },
        "description": "Tool to import a list of product codes in CSV or TSV format for normalization and matching. Use when you need to upload product code data to Taggun for receipt/invoice processing. The file should cont",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"file\": {},\n  \"raw_content\": \"\",\n  \"raw_filename\": \"\",\n  \"raw_mimetype\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taggun_import_product_categories",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/import/product/categories",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "import",
            "product",
            "categories"
          ]
        },
        "description": "Import a list of product categories and descriptions for product categorization. Accepts CSV or TSV files (less than 20MB) with category and description columns. Use this when you need to bulk import ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"file\": {},\n  \"raw_content\": \"\",\n  \"raw_filename\": \"\",\n  \"raw_mimetype\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taggun_transcribe_receipt_encoded_simple",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/transcribe/receipt/encoded/simple",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "transcribe",
            "receipt",
            "encoded",
            "simple"
          ]
        },
        "description": "Extract structured data from a receipt or invoice using base64 encoded image data. Provide a base64 encoded image (JPEG, PNG, PDF, GIF) along with filename and content type to get back extracted field",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"image\": \"\",\n  \"refresh\": false,\n  \"filename\": \"\",\n  \"language\": \"\",\n  \"incognito\": false,\n  \"ipAddress\": \"\",\n  \"containerId\": \"\",\n  \"contentType\": \"\",\n  \"extractTime\": false,\n  \"ignoreMerchantName\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taggun_transcribe_receipt_encoded_verbose",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/transcribe/receipt/encoded/verbose",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "transcribe",
            "receipt",
            "encoded",
            "verbose"
          ]
        },
        "description": "Tool to transcribe a receipt using base64 encoded image in JSON payload and return detailed results. Use when you have a base64 encoded receipt image and require comprehensive output including line it",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"image\": \"\",\n  \"refresh\": false,\n  \"filename\": \"\",\n  \"incognito\": false,\n  \"containerId\": \"\",\n  \"contentType\": \"\",\n  \"extractTime\": false,\n  \"extractLineItems\": false,\n  \"ignoreMerchantName\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taggun_transcribe_receipt_file_simple",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/transcribe/receipt/file/simple",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "transcribe",
            "receipt",
            "file",
            "simple"
          ]
        },
        "description": "Tool to upload a receipt or invoice image file and extract basic data including merchant name, total amount, tax amount, and date. Use when you need to digitize receipt data from a file (PDF, JPG, PNG",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"file\": {},\n  \"near\": \"\",\n  \"userId\": \"\",\n  \"refresh\": false,\n  \"language\": \"\",\n  \"incognito\": false,\n  \"ipAddress\": \"\",\n  \"containerId\": \"\",\n  \"extractTime\": false,\n  \"referenceId\": \"\",\n  \"subAccountId\": \"\",\n  \"ignoreMerchantName\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taggun_url",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/url",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "url"
          ]
        },
        "description": "Extract structured data from a receipt or invoice image using OCR. Provide a public URL to a receipt/invoice image (JPEG, PNG, PDF, GIF) and get back extracted fields like total amount, date, merchant",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\",\n  \"refresh\": false,\n  \"filename\": \"\",\n  \"contentType\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taggun_url_validation",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/url/validation",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "url",
            "validation"
          ]
        },
        "description": "Tool to extract and validate receipt data from a URL. Processes a receipt image from a public URL and returns extracted fields with confidence levels to assess receipt authenticity. Use when you have ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\",\n  \"filename\": \"\",\n  \"doNotSave\": false,\n  \"externalId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taggun_url_verbose",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/url/verbose",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "url",
            "verbose"
          ]
        },
        "description": "Tool to process a receipt or invoice from a URL for detailed data extraction. Use when you have a publicly accessible receipt or invoice URL and require comprehensive output including line items, merc",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\",\n  \"near\": \"\",\n  \"refresh\": false,\n  \"language\": \"\",\n  \"incognito\": false,\n  \"ipAddress\": \"\",\n  \"extractTime\": false,\n  \"referenceId\": \"\",\n  \"subAccountId\": \"\",\n  \"extractLineItems\": false,\n  \"ignoreMerchantName\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}