Integrations
Shipping, card data, storage, email, MCP, API keys, OAuth apps and webhooks.
Shipping
features/integrations/shipping has shippo, shipengine and manual adapters behind one contract: getRatesForOrder, createProviderShippingLabel, validateShippingAddress, trackShipment, cancelShippingLabel. Credentials are set on ShippingProvider records at /platform/shipping-providers. Onboarding seeds the options "Tracked bubble mailer", "Insured, signature required" and "Return shipping".
Card data and prices
- Checklists: bundled JSON built from Pokémon TCG API data. Images load from
images.pokemontcg.ioandimages.scrydex.com. - Prices: TCGCSV, see Market and repricing.
- Grading:
GradingCompanylookup templates for PSA and CGC.
Storage
S3-compatible storage via the five S3_* variables. Claim images can use Cloudinary.
SMTP for password reset and order emails.
MCP and assistant
/api/mcp-transport/[transport] forwards the caller's session cookie to /api/graphql, so tools run with the caller's permissions. Tools: listModels, searchModels, getFieldsForType, lookupInputType, queryData, createData, updateData, deleteData, modelSpecificSearch, and storefront tools (searchProducts, getProduct, cart, address, shipping, payment, placeOrder, getOrder, getCheckoutLink). The dashboard assistant at /api/completion uses OpenRouter.
API keys, OAuth, webhooks
- API keys:
of_bearer tokens with scopes, expiry and IP restrictions. SetTRUSTED_PROXY_IPSbehind a proxy. - OAuth apps:
/api/oauth/authorizeand/api/oauth/token. - Webhooks:
WebhookEndpointandWebhookEvent.