# Provanza delivery evidence

> Provanza delivery evidence is an MCP server for freight and logistics. MCP server and API for proof-of-delivery lookups, with a public fictional demo. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API, Web
- **Website:** https://provanza.app/tools/agent-quickstart
- **MCP Registry name:** app.provanza/public-delivery-evidence
- **Categories:** [freight and logistics](https://ai-powered.com/categories/freight-and-logistics)
- **Listing updated:** 2026-11-19

## About

The Provanza MCP server gives AI clients two public tools: one returns public carrier evidence guidance for a carrier slug such as gls, and the other runs a fictional proof-of-delivery demo with no arguments. The demo replays fixed responses for made-up shipments, so it contacts no carriers and creates no requests or charges.

Beyond the MCP endpoint, the website describes a production API under api.provanza.app for batch proof-of-delivery requests. Batches are sent through a preview step first, which classifies each row without starting work or using plan allowance, followed by a submit step, polling for status, and fetching a delivery artifact. Production access requires an API key created by an organization owner or admin on a Growth or Pro plan.

The page is aimed at developers wiring delivery evidence into agents or back-office tooling who want to test the workflow before creating an account.

## Features

- **Public carrier evidence lookup:** The lookup_carrier_evidence tool returns evidence guidance for a carrier slug such as gls, with no API key required.
- **Fictional proof-of-delivery demo:** run_fictional_pod_demo replays fixed outcomes for made-up shipments, including completed, needs_input and not_found results.
- **Batch preview before submit:** The production API classifies each batch row at preview so work and allowance are only used after review.
- **Status polling and input requests:** Requests report queued, processing, needs_input, completed, not_found or failed states, with inputRequired describing missing data.
- **Artifact retrieval:** Completed requests can deliver a public download URL or an inline base64 payload for the evidence file.

## Good for

- Testing how an agent handles proof-of-delivery outcomes before connecting a live account
- Looking up public carrier evidence guidance for a given carrier from an MCP client
- Adding a preview-and-approve step before billable proof-of-delivery batches are submitted
- Collecting missing postal codes from an operator when a carrier row needs more input

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http public-delivery-evidence https://provanza.app/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://provanza.app/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "public-delivery-evidence": {
      "url": "https://provanza.app/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "public-delivery-evidence": {
      "type": "http",
      "url": "https://provanza.app/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "public-delivery-evidence": {
      "serverUrl": "https://provanza.app/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://provanza.app/mcp
```

Enter a Name (for example "Provanza delivery evidence"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "public-delivery-evidence": {
      "type": "http",
      "url": "https://provanza.app/mcp"
    }
  }
}
```

## Tools

All 2 tools say they're read-only. From the server's own tool annotations; not verified by us.

- `lookup_carrier_evidence` (says read-only): Look up a documented carrier, market, and service example. Returns the issuer, evidence provenance, input requirements, availability guidance, and sources. The directory does not determine whether a particular shipment has proof.
- `run_fictional_pod_demo` (says read-only): Replay a fixed fictional batch and return the three outcomes, the public fixture URL, and the marked sample PDF URL. Creates no shipment requests or charges.

## FAQ

### Do I need an API key to use the MCP server?

No. The page says both lookup_carrier_evidence and run_fictional_pod_demo are public and require no API key.

### Does the fictional demo contact carriers or create charges?

According to the page, the demo uses no credentials, contacts no carriers, and creates no requests or charges.

### Which plans can create an API key for production?

Key creation requires an active or trialing Growth or Pro plan, and must be done by an organization owner or admin under Settings → API access.

### Does the preview step use plan allowance?

No. The page states that preview classifies each row without starting work or using allowance.

### How do I add Provanza delivery evidence to Claude Code?

Run this command in your terminal: claude mcp add --transport http public-delivery-evidence https://provanza.app/mcp

### What are the best alternatives to Provanza delivery evidence?

The closest alternatives to Provanza delivery evidence are FMCSA Carrier Vetting, PrepPort Global Service Planner, Delopt delivery dispatch and RentADriver.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [FMCSA Carrier Vetting](https://ai-powered.com/mcp/fmcsa-carrier-vetting): FMCSA Carrier Vetting is an open-source MCP server for freight and logistics.
- [PrepPort Global Service Planner](https://ai-powered.com/mcp/prepport-global-service-planner): PrepPort Global Service Planner is an MCP server for freight and logistics.
- [Delopt delivery dispatch](https://ai-powered.com/mcp/delopt-delivery-dispatch): Delopt delivery dispatch is an MCP server for freight and logistics.
- [RentADriver](https://ai-powered.com/mcp/rentadriver): RentADriver is a paid MCP server for freight and logistics.

---
Source: https://ai-powered.com/mcp/provanza-delivery-evidence
