# TradepilotUSA Provider Shortlist

> TradepilotUSA Provider Shortlist is a paid API for AI agents from www.tradepilotusa.com, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-02).

Analyzes vendor proposals from supplied source text and returns a ranked shortlist of providers with evaluation criteria, evidence gaps, and assumptions.

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/provider_shortlist/execute?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradepilotusa-provider-shortlist-4892417c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KRL0c0lIQ5nduUgOboGg0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tradepilotusa-provider-shortlist-4892417c -d '<json body>'
```

Example prompt: I have proposals from three HVAC vendors for our office retrofit project — can you rank them based on scope clarity, implementation effort, and staff training, and flag any gaps in the information they've provided? Here's the project brief and the full proposal text from each vendor.

## When to prefer this

Use this endpoint when you have collected multiple vendor or supplier proposals as raw text and need a structured, criteria-based ranking with explicit evidence gaps and assumptions documented. It is best suited for procurement decisions, RFP evaluation, and supplier shortlisting workflows where a human reviewer will validate the output. Prefer this over manual comparison when proposals are lengthy, numerous, or need traceable reasoning.

## Known failure modes

- Source text too short (below 20 character minimum) returns validation error
- Brief below minimum length (10 characters) rejected
- Ambiguous or incomplete proposals may result in large evidence_gaps lists and requires_human_review=true
- Missing vendor differentiation in proposals leads to inconclusive rankings
- Malformed JSON body returns 400 error
- Rate limiting or payment failure (x402) blocks execution

## How this service works

Rank the supplied providers using transparent criteria and missing-data handling; no external directory search is claimed. Uses buyer-supplied information only; no external research or outbound actions. Returns a draft for human review.

## Output

Returns a JSON object with a ranked provider comparison including a summary explanation of the ranking rationale, a detailed markdown artifact table scoring vendors across evaluation criteria, provenance metadata, a list of assumptions made during analysis, identified evidence gaps in the submitted proposals, and a flag indicating whether human review is recommended.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "brief": {
   "type": "string",
   "maxLength": 12000,
   "minLength": 10
  },
  "audience": {
   "type": "string",
   "maxLength": 500
  },
  "source_text": {
   "type": "string",
   "maxLength": 32000,
   "minLength": 20
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "task": "provider_shortlist",
  "summary": "Vendor B ranks higher than Vendor A due to a broader scope including staff training, despite higher cost and implementation effort. However, critical data such as current booking volume, customer feed",
  "artifact": "Illustrative excerpt from a synthetic provider check:\n## Provider Ranking for Example Door Company Scheduling Improvement Project\n\n### Evaluation Criteria\n1. **Implementation Effort**: Estimated workload and complexity to execute the vendor's proposal.\n2. **Scope Clarity**: How clearly defined and comprehensive the vendor's proposed services are.\n3. **Staff Training**: Inclusion and extent of training offered to staff.\n\n### Providers\n| Vendor | Proposal Description                        | Price | Implementation Effort | Scope Clarity | Staff Train",
  "provenance": {
   "source": "buyer_supplied",
   "generated_at": "2026-09-22T14:41:24.882Z",
   "external_research_performed": false
  },
  "request_id": "example_provider_shortlist",
  "assumptions": [
   "Implementation effort is inferred from the complexity of proposed services.",
   "Scope clarity is judged by the breadth of services described."
  ],
  "evidence_gaps": [
   "Details on the depth and deliverables of the process assessments.",
   "Specific content and duration of the staff workshop."
  ],
  "requires_human_review": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepilotusa-provider-shortlist-4892417c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.tradepilotusa.com](https://www.zero.xyz/host/www.tradepilotusa.com/llms.txt)