Ziptax Sales Tax API

Para obtener Markdown limpio de cualquier página, añade .md a la URL de la página. Para un índice completo de documentación, consulta https://docs.zip.tax/llms.txt. Para integración con clientes de IA (Claude Code, Cursor, etc.), conéctate al servidor MCP en https://docs.zip.tax/_mcp/server.

Servidor MCP

El servidor MCP de Ziptax brinda a los agentes de IA y aplicaciones impulsadas por LLM acceso directo a datos de impuestos sobre ventas en tiempo real de EE. UU. y Canadá. MCP es un estándar abierto que permite a las aplicaciones de IA conectarse de forma segura a herramientas y fuentes de datos externas. Una vez conectado, tu agente puede:

• Consultar tasas de impuestos sobre ventas y uso por código postal, dirección postal o coordenadas geográficas.
• Obtener desgloses de impuestos a nivel de jurisdicción (estado, condado, ciudad y distrito).
• Consultar métricas de uso de cuenta e información de cuotas.

Necesitarás una clave de API de Ziptax válida. Crea una cuenta gratuita en platform.zip.tax.

Detalles de conexión

URL base	https://mcp.zip-tax.com/
Método	POST
Transporte	Streamable HTTP (la mayoría de los clientes lo llaman HTTP)

Autenticación

Cada solicitud debe incluir una clave de API válida enviada como encabezado HTTP. Se admiten dos métodos de encabezado.

X-API-KEY encabezado (recomendado)

X-API-KEY: your-api-key

Authorization encabezado

Authorization: Bearer your-api-key

Si ambos están presentes, el encabezado X-API-KEY tiene prioridad. No pases tu clave de API como parámetro de URL; las claves en las URLs pueden terminar en registros.

Herramientas

El servidor expone dos herramientas.

lookup_tax_rate

Consulta las tasas de impuestos sobre ventas y uso para una ubicación en EE. UU. o Canadá. Proporciona una dirección postal completa para precisión a nivel de puerta, o un par lat/lng para una búsqueda por punto geográfico. Devuelve tasas de impuestos desglosadas por jurisdicción (estado, condado, ciudad, distrito).

Parámetros

Proporciona address para una búsqueda a nivel de puerta, o lat y lng para una búsqueda por punto geográfico. El esquema de entrada declara este requisito como una restricción anyOf.

Ejemplo de respuesta

La respuesta de la herramienta refleja la respuesta de la API REST por dirección de Ziptax:

{
  "metadata": {
    "version": "v60",
    "response": {
      "code": 100,
      "name": "RESPONSE_CODE_SUCCESS",
      "message": "Successful API Request.",
      "definition": "http://api.zip-tax.com/request/v60/schema"
    }
  },
  "baseRates": [
    {
      "rate": 0.0725,
      "jurType": "US_STATE_SALES_TAX",
      "jurName": "CA",
      "jurDescription": "US State Sales Tax",
      "jurTaxCode": "06"
    },
    {
      "rate": 0.005,
      "jurType": "US_COUNTY_SALES_TAX",
      "jurName": "ORANGE",
      "jurDescription": "US County Sales Tax",
      "jurTaxCode": "30"
    }
  ],
  "taxSummaries": [
    {
      "rate": 0.0775,
      "taxType": "SALES_TAX",
      "summaryName": "Total Base Sales Tax",
      "displayRates": [
        { "name": "Total Rate", "rate": 0.0775 }
      ]
    }
  ],
  "addressDetail": {
    "normalizedAddress": "200 Spectrum Center Dr, Irvine, CA 92618-5003, United States",
    "incorporated": "true",
    "geoLat": 33.65253,
    "geoLng": -117.74794
  }
}

get_account_metrics

Recupera métricas de uso de cuenta e información de cuota para tu cuenta de Ziptax. Devuelve recuentos de solicitudes actuales, límites y derechos. No toma parámetros.

Casos de uso de ejemplo

Una vez conectado, pregúntale a tu agente cosas como:

• "¿Cuál es la tasa de impuesto sobre ventas para el código postal 90210?"
• "¿Cuál es la tasa combinada de impuesto sobre ventas en 200 Spectrum Center Dr, Irvine, CA?"
• "¿Cuál es la tasa de impuesto sobre ventas para el código postal canadiense M5V 2T6 en Toronto, Ontario?"
• "¿Cuál fue la tasa de impuesto sobre ventas en Nashville, TN (37203) en enero de este año?"
• "¿Cuántas solicitudes de API quedan en mi plan de Ziptax este mes?"

Configuración del cliente

A continuación se muestran ejemplos de configuración para conectar clientes MCP populares al servidor MCP de Ziptax. Reemplaza your_api_key con tu clave de API de Ziptax de platform.zip.tax.

Claude Desktop

Añade este bloque a tu claude_desktop_config.json:

{
  "mcpServers": {
    "ziptax": {
      "type": "http",
      "url": "https://mcp.zip-tax.com/",
      "headers": {
        "X-API-KEY": "your_api_key"
      }
    }
  }
}

Cursor

Navega a Configuración → MCP y añade un nuevo servidor con:

• Nombre: Ziptax MCP Server
• Tipo: HTTP
• URL: https://mcp.zip-tax.com/
• Encabezados: X-API-KEY: your_api_key

Devin

En Devin, añade la integración MCP de Ziptax desde el MCP Marketplace, o configúrala manualmente en Configuración → MCP Marketplace → Añadir el tuyo:

{
  "mcpServers": {
    "ziptax-sales-tax-api": {
      "transport": "shttp",
      "url": "https://mcp.zip-tax.com/",
      "headers": {
        "X-API-KEY": "$ZIPTAX_API_KEY"
      }
    }
  }
}

Guarda tu clave de API como un secreto llamado ZIPTAX_API_KEY en el Administrador de secretos de Devin.

Cliente MCP genérico

Cualquier cliente MCP que admita transporte HTTP Streamable puede conectarse:

• Nombre: Ziptax MCP Server
• Tipo: HTTP
• URL: https://mcp.zip-tax.com/
• Encabezados: X-API-KEY: your_api_key

Manejo de errores

Cuando una solicitud falla, el servidor MCP devuelve un mensaje de error en el resultado de la herramienta. Para la lista completa de códigos de respuesta de la API, consulta la referencia de Códigos de respuesta.