Hosted MCP · Streamable HTTP

Connect tariff workflows to your AI client

Connect with OAuth from a compatible AI client, or use an API key for model APIs and custom integrations. Tool calls inherit your USTariffRates account's plan, credits, billing capability, and provenance rules.

Client setup

https://mcp.ustariffrates.com

In Gemini Enterprise Business, an administrator adds this URL under Connected apps. Gemini discovers USTariffRates OAuth, then opens a consent flow for a signed-in USTariffRates account.

MCP Server URL

https://mcp.ustariffrates.com/mcp

Available workflows

Curated tools instead of one tool per REST endpoint.

search_tariffs

Search US HTS classifications

lookup_tariff

Resolve a source-backed tariff stack

calculate_duty

Calculate supported duties and fees

replay_tariff

Replay a supported historical date

compare_tariff_codes

Compare US, EU, GB, and Brazil classifications

list_tariff_changes

Review monitored changes (Pro+)

audit_entry

Audit customs-entry lines (Team+)

OAuth connection

Compatible clients discover the authorization server from the endpoint. Sign in to USTariffRates, review the requested access, and approve the connection. The client receives a revocable token—not your password or API key.

Security and billing

  • OAuth is preferred for interactive clients; keep API keys in secret storage for code integrations.
  • Start with tool approvals enabled in model APIs.
  • Every tool call is attributed to the approving USTariffRates account.
  • Included and prepaid credits are used first. Postpaid usage requires a separately verified collection capability.
  • Wallet and x402 payments are reserved but not enabled.

Gemini Enterprise administrator checklist

  1. 1. In Gemini Enterprise Business, open Connected apps and add a custom MCP server.
  2. 2. Enter https://mcp.ustariffrates.com/mcp as the MCP Server URL. The transport is Streamable HTTP.
  3. 3. Start authorization. USTariffRates opens in the browser so a signed-in account owner can review and approve the connection.
  4. 4. Standard access uses mcp:read. Entry-audit access additionally uses mcp:audit. mcp:tools remains a legacy compatibility scope for existing grants.
  5. 5. After consent, confirm Gemini can list the standard tariff tools. The audit_entry tool appears only when entry-audit access is approved and the account plan permits it.

Gemini Enterprise custom MCP connections are currently a Pre-GA Google feature with limited support. Availability and administrator labels may change on Google's side.

Need raw endpoint details? Review the complete API reference.

Frequently asked questions