Name: card-resolve
Price: 0.005 USDC
Availability: InStock

$ man card-resolve

agentutility / wordmint / card-resolve

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

wordmint

CATEGORY

STATUS

● live

NAME

card-resolve — card resolver / graded card string normalizer / free-form card text to canonical card object

SYNOPSIS

POST https://x402.agentutility.ai/card-resolve
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Card resolver / graded card string normalizer / free-form card text to canonical card object. Takes any descriptive string ('2018 Topps Update Juan Soto RC PSA 9', '1999 Pokemon Base Set Charizard Holo PSA 10', 'MTG Black Lotus Alpha BGS 8.5') and returns a structured object: sport_or_tcg, year, set, player_or_card_name, parallel, grade, grader, cert_number. Plus a confidence score and a deterministic search_key suitable for downstream cache coherence. Pure LLM extraction (Morpheus primary, Venice fallback), no upstream data lookups. The clean glue endpoint for collector-pricing bots, marketplace listing automations, AI-shopping agents, and portfolio trackers that need to normalize messy human descriptions before any further lookup.

INPUT — request schema

property	type	description	req?
card	string	Free-form card description. Max 500 chars. Examples: '2018 Topps Update Juan Soto RC PSA 9', '1999 Pokemon Base Set Charizard Holo 1st Edition PSA 10'.	required

OUTPUT — response shape

field	type	description
input	string	Echo of the original free-form card description submitted to the resolver.
canonical	object	Structured card object with fields: sport_or_tcg (sports/pokemon/magic/yugioh/other), year, set, player_or_card_name, parallel, grade, grader (PSA/BGS/SGC/CGC), cert_number.
confidence	number	Extractor confidence score 0-1. Treat values below 0.5 as low-confidence resolutions worth re-validating.
search_key	string	Deterministic lower-kebab key. Same canonical card always produces the same key regardless of input phrasing — useful as a cache coherence key for downstream comp lookups.
model	string	LLM model identifier that produced the extraction (Morpheus hermes-3 or Venice mistral-small fallback).
source	string	Which provider served the response: 'morpheus' (primary) or 'venice' (fallback).

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/card-resolve \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# MCP packages on npm under
# @agentutility/mcp-*  (one per cluster)
#
# Catalog + install:
# https://mcp.agentutility.ai
#
# Or call card-resolve directly over HTTP — see above.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: wordmintcard-extractiongraded-cardstcgsports-cardsstructured-output
env: VENICE_API_KEY
methods: POST
cluster: wordmint
price: $0.005 USDC per call

ADJACENT — other endpoints in wordmint

endpoint	description	price
detect-language	Language detector / language identification.	$0.005
extract-entities	Named entity recognition (NER) / entity extractor.	$0.005
pii-redact	PII redactor / mask emails phones SSNs IBANs credit cards IPs / GDPR safe text / privacy scrubber.	$0.005
prompt-compress	Prompt compressor / context shrinker / prompt distiller / cost-cutter for long system prompts.	$0.005
retrieval-rerank	Retrieval reranker / RAG reranker / document scoring / top-k filter / cross-encoder substitute.	$0.005
text-classify	Text classifier.	$0.005
tool-card-generate	Tool card generator / OpenAI function-calling spec / A2A tool-card / agent tool description.	$0.005
translate	AI translator.	$0.005