Ziptax Sales Tax API

Para obtener Markdown limpio de cualquier página, añade .md al final de 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 que las aplicaciones de IA se conecten 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.
• Recuperar desgloses de impuestos a nivel de jurisdicción (estatal, condado, ciudad y distrito).
• Consultar métricas de uso de la cuenta e información de cuota.

Información

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	HTTP transmisible (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.

Encabezado X-API-KEY (recomendado)

X-API-KEY: your-api-key

Encabezado Authorization

Authorization: Bearer your-api-key

Advertencia

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 URL pueden terminar en los registros.

Herramientas

El servidor expone dos herramientas.

lookup_tax_rate

Consulta 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 consulta por punto geográfico. Devuelve tasas de impuestos desglosadas por jurisdicción (estatal, condado, ciudad, distrito).

Parámetros

Proporciona address para una consulta a nivel de puerta, o lat y lng para una consulta por punto geográfico. El esquema de entrada declara este requisito como una restricción de 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 la cuenta e información de cuota para tu cuenta de Ziptax. Devuelve conteos 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 impuestos sobre ventas para el código postal 90210?"
• "¿Cuál es la tasa combinada de impuestos sobre ventas en 200 Spectrum Center Dr, Irvine, CA?"
• "¿Cuál es la tasa de impuestos sobre ventas para el código postal canadiense M5V 2T6 en Toronto, Ontario?"
• "¿Cuál fue la tasa de impuestos 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

Agrega 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 agrega un nuevo servidor con:

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

Devin

En Devin, agrega la integración MCP de Ziptax desde el Mercado MCP, o configúrala manualmente en Configuración → Mercado MCP → Agregar el tuyo propio:

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

Almacena 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 transmisible puede conectarse:

• Nombre: Servidor MCP de Ziptax
• 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.