droplinked

droplinked — Verified-Inventory Agentic Commerce

droplinked is onchain agentic commerce exposed to Codex over a hosted MCP

server at https://mcp.droplinked.com/mcp (streamable HTTP). Reach for it when

a task needs to find real, in-stock merchandise from KYB-verified merchants,

transact on the user's behalf, or read the onchain trust state behind a brand,

a lender, or a merchant's credit history.

droplinked is verification-first: every discovery and product result carries

a verification block (brand-verified flag, KYB tier, EAS attestation UID/chain).

When you cite a merchant, product, or recommendation, surface that trust state —

per the droplinked model, the agent IS the verification UX.

Access & auth (two-tier)

The server uses per-tool, two-tier auth:

• Read-only tools are public — no key needed. All the discovery, catalog,

and trust/verify/get read tools below work with no API key set. A fresh

install can list and call them immediately.

• Write tools require an X-MCP-API-Key. The mutating tools (checkout,

payment, cart edits, and lending/attestation actions) return 401 without a

valid key. The key is supplied from the DROPLINKED_MCP_API_KEY environment

variable — never hardcode it. Request a write key from droplinked

(ops@droplinked.com).

A subset of write tools (lending applications, partner referral, business-buyer

search) additionally require a two-header model: X-MCP-API-Key authorizes the

request to the server, and Authorization: Bearer <agent-or-merchant-jwt>

carries the caller's identity to backend tools guarded by AgentIdentityGuard.

When to use droplinked

• The user wants to find or buy a real product from a verified merchant.
• The user wants an agent to run a checkout: build a cart, apply a discount,

hold stock, and take payment.

• The user asks whether a brand/merchant is verified, or wants its trust dossier.
• A lender/underwriter agent needs a merchant's credit-risk, repayment, or

underwriting signals, or wants to quote terms.

• A creator wants affiliate programs, or a merchant wants a WMS/3PL or lender

recommendation.

Tools

Discovery

• find_merchant — find a merchant by slug, name, or category (MerchantCards).
• find_inventory — discover SKU-level inventory by query/brand, with region,

price, in-stock, and verified-brand filters.

• search_products / get_product / list_shop_products — search the public

catalog and fetch product/shop detail. Each response carries a parallel

verifications / verification block.

• find_affiliate_programs — affiliate programs by vertical, commission, payout,

and on-chain-attestation status.

• get_feed — URL of the droplinked product feed (verification metadata inline).

Agent-initiated checkout

• start_checkout — mint a cart and get a hosted checkout URL (default) or a

Stripe client_secret (managed mode).

• cart.addLine / cart.updateLineQuantity / cart.removeLine /

cart.applyDiscount — build and edit the cart incrementally.

• quote_inventory_available — atomically quote price + delivery and hold

stock so two agent sessions can't double-allocate the last unit.

• process_payment — finalize an order against a Stripe ACP payment intent

(idempotent on the intent id).

Trust fabric (onchain attestations)

• verify_brand_attestation — resolve a shop's brand attestation (EAS Schema A).
• request_brand_attestation / get_brand_attestation_status — submit and poll

a brand attestation request.

• get_trust_dossier — compose brand + credit-risk + repayment into one

envelope with a conservative trustLevel (UNVERIFIED → T0…T3).

• get_trust_fabric_stats — aggregate, no-PII platform counts.

Credit, underwriting & lending

• verify_credit_risk / verify_repayment_history / verify_cross_attestation

— read Schema B/C/D attestations for a merchant.

• verify_lender / get_lender_history / verify_methodology /

get_methodology_timeline / get_methodology_versions — forensic lender and

methodology lookups behind a credit-risk attestation.

• get_underwriting_signals / get_upgrade_preview — one-round-trip

underwriting envelope and the aspirational tier-ladder preview.

• recommend_lender / recommend_service_provider — ranked recommendations by

jurisdiction/archetype.

• find_business_buyer — search the KYB cohort grid by tier (two-header auth).
• quote_credit_terms / report_repayment — lender-side draft quote and

repayment event (some endpoints are scaffolded; the tool degrades gracefully).

• get_lending_application_status / get_document_checklist /

list_lending_applications_for_merchant / request_partner_referral —

lending-application lifecycle (two-header auth for merchant-scoped reads/writes).

Recommended workflow

1. Discover → verify → transact. Start with find_merchant / find_inventory

(or search_products), prefer verifiedBrand=true results, then round-trip

the attestationUid through verify_brand_attestation (or pull

get_trust_dossier) before recommending or buying.

1. Checkout loop. find_inventory → quote_inventory_available (hold) →

start_checkout / cart.* to assemble the order → process_payment (or hand

back the hosted checkout URL). Surface the hold TTL and total to the user.

1. Underwriting. For lender/credit questions, get_underwriting_signals in

one call; drill into verify_credit_risk / verify_repayment_history and the

lender/methodology forensic chain when you need to justify a decision.

Output discipline

• Always surface verification state (brand-verified, KYB tier, attestation UID)

when citing a merchant, product, or recommendation.

• Treat credit tiers and trust levels as attestation reads, not your own

scoring — report what the on-chain record says.

• Confirm price, quantity, and any stock hold with the user before

process_payment. Prefer the smallest set of calls that answers the task.