{
  "info": {
    "name": "Taxjar — mcp.ai",
    "description": "REST API for the Taxjar 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/taxjar",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "taxjar_calculate_sales_tax_for_an_order",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/calculate/sales/tax/for/an/order",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "calculate",
            "sales",
            "tax",
            "for",
            "an",
            "order"
          ]
        },
        "description": "Tool to calculate sales tax for an order. Use when you need an accurate tax calculation including nexus addresses, line items, shipping, and exemptions.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"amount\": 0,\n  \"to_zip\": \"\",\n  \"to_city\": \"\",\n  \"from_zip\": \"\",\n  \"shipping\": 0,\n  \"to_state\": \"\",\n  \"from_city\": \"\",\n  \"to_street\": \"\",\n  \"from_state\": \"\",\n  \"line_items\": \"\",\n  \"to_country\": \"\",\n  \"customer_id\": \"\",\n  \"from_street\": \"\",\n  \"from_country\": \"\",\n  \"exemption_type\": \"\",\n  \"nexus_addresses\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_create_customer",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/customer",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "customer"
          ]
        },
        "description": "Tool to create a new customer with exemption information. Use when you need to add a customer to your TaxJar account for tax exemption management.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"zip\": \"\",\n  \"city\": \"\",\n  \"name\": \"\",\n  \"state\": \"\",\n  \"street\": \"\",\n  \"country\": \"\",\n  \"customer_id\": \"\",\n  \"exempt_regions\": \"\",\n  \"exemption_type\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_create_order_transaction",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/order/transaction",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "order",
            "transaction"
          ]
        },
        "description": "Creates a new order transaction in TaxJar for sales tax reporting and compliance. This action records order transactions that will appear in the TaxJar dashboard for tax filing purposes. The transacti",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"amount\": 0,\n  \"to_lat\": 0,\n  \"to_lng\": 0,\n  \"to_zip\": \"\",\n  \"to_city\": \"\",\n  \"user_id\": \"\",\n  \"shipping\": 0,\n  \"to_state\": \"\",\n  \"sales_tax\": 0,\n  \"to_street\": \"\",\n  \"line_items\": \"\",\n  \"to_country\": \"\",\n  \"exemption_type\": \"\",\n  \"transaction_id\": \"\",\n  \"nexus_addresses\": \"\",\n  \"transaction_date\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_create_refund_transaction",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/refund/transaction",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "refund",
            "transaction"
          ]
        },
        "description": "Tool to create a new refund transaction. Use after confirming refund details.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"amount\": 0,\n  \"to_zip\": \"\",\n  \"to_city\": \"\",\n  \"provider\": \"\",\n  \"shipping\": 0,\n  \"to_state\": \"\",\n  \"sales_tax\": 0,\n  \"to_street\": \"\",\n  \"line_items\": \"\",\n  \"to_country\": \"\",\n  \"transaction_id\": \"\",\n  \"transaction_date\": \"\",\n  \"transaction_reference_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_delete_customer",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/customer",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "customer"
          ]
        },
        "description": "Tool to delete an existing customer. Use when you need to remove a previously created customer by its ID. Example: \"Delete customer cust_12345\".",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"customer_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_delete_order_transaction",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/order/transaction",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "order",
            "transaction"
          ]
        },
        "description": "Tool to delete an existing order transaction. Use when you need to remove a previously created order transaction by its ID. Example: \"Delete transaction abc123\".",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"transaction_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_delete_refund_transaction",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/refund/transaction",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "refund",
            "transaction"
          ]
        },
        "description": "Tool to delete an existing refund transaction. Use when you need to remove a previously created refund transaction by its ID. Example: \"Delete refund 243345\".",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"transaction_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_list_customers",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/customers",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "customers"
          ]
        },
        "description": "Lists all customer IDs from your TaxJar account. Returns a paginated list of customer IDs (strings). To get full details for a specific customer (including name, address, exemption type, etc.), use th",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_list_nexus_regions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/nexus/regions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "nexus",
            "regions"
          ]
        },
        "description": "Tool to list existing nexus regions for an account. Use after authenticating your account to discover where you have nexus for sales tax purposes.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_list_order_transactions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/order/transactions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "order",
            "transactions"
          ]
        },
        "description": "List order transaction IDs within a date range. Returns an array of transaction IDs (strings) for orders created between the specified dates. Use this to discover which orders exist in a date range, t",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"provider\": \"\",\n  \"to_transaction_date\": \"\",\n  \"from_transaction_date\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_list_refund_transactions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/refund/transactions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "refund",
            "transactions"
          ]
        },
        "description": "Lists refund transaction IDs within a specified date range. Returns an array of transaction IDs only. To get detailed information about a specific refund, use the 'Show refund transaction' action with",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"provider\": \"\",\n  \"to_transaction_date\": \"\",\n  \"from_transaction_date\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_list_tax_categories",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/tax/categories",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "tax",
            "categories"
          ]
        },
        "description": "Tool to list all product tax categories and their codes. Use when you need to discover available tax categories before assigning them to products.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_show_customer",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/show/customer",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "show",
            "customer"
          ]
        },
        "description": "Tool to show an existing customer. Use when you need to retrieve details of a specific customer via TaxJar API.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"customer_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_show_order_transaction",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/show/order/transaction",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "show",
            "order",
            "transaction"
          ]
        },
        "description": "Tool to show an existing order transaction by ID. Use when you need to retrieve full details of a specific order transaction after creation or listing.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"transaction_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_show_refund_transaction",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/show/refund/transaction",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "show",
            "refund",
            "transaction"
          ]
        },
        "description": "Retrieves detailed information about a specific refund transaction from TaxJar. Use this tool when you need to: - View complete details of a refund transaction including amounts, addresses, and line i",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"transaction_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_show_tax_rates_for_a_location",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/show/tax/rates/for/a/location",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "show",
            "tax",
            "rates",
            "for",
            "a",
            "location"
          ]
        },
        "description": "Tool to show sales tax rates for a location. Use when you need to retrieve sales tax rates for a specific ZIP code with optional address details (city, state, country, street).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"zip\": \"\",\n  \"city\": \"\",\n  \"state\": \"\",\n  \"street\": \"\",\n  \"country\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_summarize_tax_rates_for_all_regions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/summarize/tax/rates/for/all/regions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "summarize",
            "tax",
            "rates",
            "for",
            "all",
            "regions"
          ]
        },
        "description": "Tool to retrieve minimum and average sales tax rates by region. Use when you need a backup of regional tax summary rates.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_update_customer",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/customer",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "customer"
          ]
        },
        "description": "Tool to update an existing customer in TaxJar. Use when you need to modify customer details such as exemption type, name, or address information.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"zip\": \"\",\n  \"city\": \"\",\n  \"name\": \"\",\n  \"state\": \"\",\n  \"street\": \"\",\n  \"country\": \"\",\n  \"customer_id\": \"\",\n  \"exempt_regions\": \"\",\n  \"exemption_type\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_update_order_transaction",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/order/transaction",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "order",
            "transaction"
          ]
        },
        "description": "Tool to update an existing order transaction. Use when adjusting order details such as amount, shipping, or line items after creation.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"amount\": 0,\n  \"to_zip\": \"\",\n  \"to_city\": \"\",\n  \"provider\": \"\",\n  \"shipping\": 0,\n  \"to_state\": \"\",\n  \"sales_tax\": 0,\n  \"to_street\": \"\",\n  \"line_items\": \"\",\n  \"to_country\": \"\",\n  \"transaction_id\": \"\",\n  \"transaction_date\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_update_refund_transaction",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/refund/transaction",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "refund",
            "transaction"
          ]
        },
        "description": "Tool to update an existing refund transaction. Use when adjusting refund details such as amount, shipping, or line items after creation.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"amount\": 0,\n  \"to_zip\": \"\",\n  \"to_city\": \"\",\n  \"from_zip\": \"\",\n  \"shipping\": 0,\n  \"to_state\": \"\",\n  \"from_city\": \"\",\n  \"sales_tax\": 0,\n  \"to_street\": \"\",\n  \"from_state\": \"\",\n  \"line_items\": \"\",\n  \"to_country\": \"\",\n  \"customer_id\": \"\",\n  \"from_street\": \"\",\n  \"from_country\": \"\",\n  \"exemption_type\": \"\",\n  \"transaction_id\": \"\",\n  \"transaction_date\": \"\",\n  \"transaction_reference_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "taxjar_validate_vat_number",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/validate/vat/number",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "validate",
            "vat",
            "number"
          ]
        },
        "description": "Validates EU VAT identification numbers against the VIES (VAT Information Exchange System) database. Use this tool to: - Verify VAT number format and validity - Check if a VAT number is registered and",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"vat_number\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}