Server definition

Hash: sha256:46db791e204a65668c915c834028d7b00f7eb31eaf50ef7ffb1db8a58e0296c7
What it is: What a remote MCP server returned when asked what it offers: 23 tools

The blob, as servednamed by its sha256

{
  "instructions": null,
  "tools": [
    {
      "description": "Cancel a cart. Idempotent, owner-scoped, and moves no money. REQUIRES IDENTITY plus an Idempotency-Key on a signature-required Terminal.",
      "inputSchema": {
        "properties": {
          "id": {
            "description": "The cart id.",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "name": "cancel_cart",
      "outputSchema": null
    },
    {
      "description": "Cancel a checkout session before completion, releasing its inventory hold. Idempotent, owner-scoped, and moves no money (distinct from an escrow refund). REQUIRES IDENTITY plus an Idempotency-Key on a signature-required Terminal.",
      "inputSchema": {
        "properties": {
          "id": {
            "description": "The checkout session id.",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "name": "cancel_checkout",
      "outputSchema": null
    },
    {
      "description": "Complete a checkout you created and place the order by submitting the buyer-signed payment credential. This is the MONEY-MOVING leg: funds capture on-chain to the merchant's pay_to (x402) or into escrow (Boson). The amount is re-derived server-side from the reservation, never your request, and the buyer's signature is verified before any capture. A per-buyer refusal (FORBIDDEN, cap-exceeded, FULFILLMENT_REQUIRED) returns as an error result; a missing or invalid identity is a real 401. REQUIRES IDENTITY plus a signed Idempotency-Key on a signature-required Terminal.",
      "inputSchema": {
        "properties": {
          "checkout_id": {
            "description": "The checkout id from create_checkout.",
            "type": "string"
          },
          "payment": {
            "description": "The payment container `{ instruments: [{ credential: { type, ... } }] }`, where credential.type is `x402_authorization` or `boson_commit_authorization`. Sign the seller-signed offer LOCALLY with your own wallet; Facet never holds your key.",
            "type": "object"
          }
        },
        "required": [
          "checkout_id",
          "payment"
        ],
        "type": "object"
      },
      "name": "complete_checkout",
      "outputSchema": null
    },
    {
      "description": "Create a pre-checkout cart from catalog line items. A cart is a mutable scratchpad: it moves no money and holds no inventory, so it carries estimated (server-derived) totals and NO payment_handlers. Assemble it, then create_checkout(cart_id) to convert. REQUIRES IDENTITY on a signature-required Terminal.",
      "inputSchema": {
        "properties": {
          "line_items": {
            "description": "Items, each `{ item: { id }, quantity }`. Prices are catalog-derived, never yours.",
            "items": {
              "properties": {
                "item": {
                  "properties": {
                    "id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id"
                  ],
                  "type": "object"
                },
                "quantity": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "name": "create_cart",
      "outputSchema": null
    },
    {
      "description": "Open a checkout session for one or more catalog line items (or promote a cart with `cart_id`). Returns the session plus server-resolved `payment_handlers` (rail, pay_to, exact amount) to satisfy: the price and pay_to are the MERCHANT's, sealed here, never read from your request. Physical goods REQUIRE a `fulfillment` ship-to (else FULFILLMENT_REQUIRED), sealed at create. REQUIRES IDENTITY on a signature-required Terminal: a Facet KYA as `Authorization: Bearer <kya>`.",
      "inputSchema": {
        "properties": {
          "cart_id": {
            "description": "Promote an existing cart: its stored lines drive the checkout and any line_items are ignored (the business must use the cart contents).",
            "type": "string"
          },
          "fulfillment": {
            "description": "Ship-to destination. REQUIRED for physical products; sealed at create.",
            "type": "object"
          },
          "line_items": {
            "description": "Items to buy, each `{ item: { id }, quantity }`. Omit when using cart_id.",
            "items": {
              "properties": {
                "item": {
                  "properties": {
                    "id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id"
                  ],
                  "type": "object"
                },
                "quantity": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "name": "create_checkout",
      "outputSchema": null
    },
    {
      "description": "Find businesses in the Facet Universal Business Index that an agent can transact with. Returns `featured` (claimed merchants with a live `terminal_url` — point your catalog and checkout calls there) and `results` (the wider directory). Use this first when you do not already know which merchant to talk to. REQUIRES IDENTITY: send a Facet KYA as `Authorization: Bearer <kya>` on the MCP request. A KYA is an ES256 JWT from Facet's default issuer https://issuer.facet.llc (or another issuer this Terminal trusts — see KYA-Issuers in its /.well-known/agents.txt). Calling without one returns 401 with a signup link.",
      "inputSchema": {
        "properties": {
          "limit": {
            "description": "Max matches to return. Default 10, cap 50.",
            "maximum": 50,
            "minimum": 1,
            "type": "integer"
          },
          "near": {
            "description": "Optional geographic center to rank by proximity.",
            "properties": {
              "lat": {
                "description": "Latitude, decimal degrees.",
                "type": "number"
              },
              "lng": {
                "description": "Longitude, decimal degrees.",
                "type": "number"
              }
            },
            "required": [
              "lat",
              "lng"
            ],
            "type": "object"
          },
          "query": {
            "description": "Free-text query, e.g. \"flowers\" or \"makeup brushes\".",
            "type": "string"
          },
          "radius_km": {
            "description": "Search radius around `near`, km. Default 25.",
            "type": "number"
          }
        },
        "type": "object"
      },
      "name": "discover_businesses",
      "outputSchema": null
    },
    {
      "description": "Search products ACROSS every merchant in the Facet network that has opted into cross-merchant discovery. Returns matches each carrying the selling merchant's `terminal_url` (point your catalog and checkout calls there). Filter by free-text `query` (product name + description), exact `category`, and/or `tags` (all must be present); at least one filter is required. Use this when you know WHAT you want but not WHICH merchant sells it. REQUIRES IDENTITY: send a Facet KYA as `Authorization: Bearer <kya>` on the MCP request. A KYA is an ES256 JWT from Facet's default issuer https://issuer.facet.llc (or another issuer this Terminal trusts; see KYA-Issuers in its /.well-known/agents.txt). Calling without one returns 401 with a signup link.",
      "inputSchema": {
        "properties": {
          "category": {
            "description": "Exact product category to match.",
            "type": "string"
          },
          "limit": {
            "description": "Max matches to return. Default 10, cap 50.",
            "maximum": 50,
            "minimum": 1,
            "type": "integer"
          },
          "query": {
            "description": "Free-text over product name + description, e.g. \"lavender soap\".",
            "type": "string"
          },
          "tags": {
            "description": "Tags that must ALL be present on a matching product.",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "name": "discover_products",
      "outputSchema": null
    },
    {
      "description": "Read back one of YOUR carts by id: line items and estimated totals. Owner-scoped, so another agent's id returns not_found. REQUIRES IDENTITY on a signature-required Terminal.",
      "inputSchema": {
        "properties": {
          "id": {
            "description": "The cart id.",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "name": "get_cart",
      "outputSchema": null
    },
    {
      "description": "Read back one of YOUR checkout sessions by id: status, totals, line items, payment_handlers. Owner-scoped, so another agent's id returns not_found. REQUIRES IDENTITY on a signature-required Terminal.",
      "inputSchema": {
        "properties": {
          "id": {
            "description": "The checkout session id.",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "name": "get_checkout",
      "outputSchema": null
    },
    {
      "description": "Read back one of YOUR orders on this merchant: status, amount, settlement state. Use the order_id returned when you paid. You can only read orders your own agent identity placed — another agent's order returns FORBIDDEN. REQUIRES IDENTITY: Facet KYA as `Authorization: Bearer <kya>`.",
      "inputSchema": {
        "properties": {
          "order_id": {
            "description": "The order id returned at payment.",
            "type": "string"
          }
        },
        "required": [
          "order_id"
        ],
        "type": "object"
      },
      "name": "get_order",
      "outputSchema": null
    },
    {
      "description": "Which settlement rails this merchant actually accepts (e.g. coin/boson-escrow for escrowed funds that release on fulfilment, coin/usdc-base for direct). Call before get_payment_requirements so you pass a rail_id this merchant registers, rather than guessing. No identity required — this is discovery data.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "get_payment_capabilities",
      "outputSchema": null
    },
    {
      "description": "Turn a `quote_token` from get_quote into a seller-signed payment offer to authorize. Returns `requirements` (escrow address, asset, exact atomic amount, network) — sign it LOCALLY with your own wallet (e.g. @bosonprotocol/x402-client handle402 for `coin/boson-escrow`, producing an X-PAYMENT string). Facet never holds your key and cannot sign for you, which is why paying is two steps and not one. The offer binds to the quote_token's sealed landed total and ship-to, so the amount is the merchant's, not one you name. REQUIRES IDENTITY: same Facet KYA as get_quote, and the SAME `aid` — the offer path rejects a quote_token issued to a different agent than the caller.",
      "inputSchema": {
        "properties": {
          "amount": {
            "description": "The landed total in ATOMIC units. Must equal the quote_token's sealed total.",
            "properties": {
              "amount": {
                "description": "Atomic units, e.g. 16930000 for $16.93 USDC (6dp).",
                "type": "integer"
              },
              "currency": {
                "description": "e.g. \"USDC\".",
                "type": "string"
              }
            },
            "required": [
              "amount",
              "currency"
            ],
            "type": "object"
          },
          "product_id": {
            "description": "Must match the product the quote_token sealed.",
            "type": "string"
          },
          "qty": {
            "description": "Must match the quote_token. Default 1.",
            "minimum": 1,
            "type": "integer"
          },
          "quote_token": {
            "description": "The signed token from get_quote.",
            "type": "string"
          },
          "rail_id": {
            "description": "Settlement rail, e.g. \"coin/boson-escrow\" (escrow: funds release on fulfilment) or \"coin/usdc-base\". See /v1/payments/capabilities for what this merchant registers.",
            "type": "string"
          },
          "site_id": {
            "description": "Usually omitted — this Terminal's bound site is used.",
            "type": "string"
          }
        },
        "required": [
          "product_id",
          "rail_id",
          "amount",
          "quote_token"
        ],
        "type": "object"
      },
      "name": "get_payment_requirements",
      "outputSchema": null
    },
    {
      "description": "Get full product detail by product or variant identifier.",
      "inputSchema": {
        "properties": {
          "catalog": {
            "properties": {
              "id": {
                "type": "string"
              }
            },
            "required": [
              "id"
            ],
            "type": "object"
          }
        },
        "required": [
          "catalog"
        ],
        "type": "object"
      },
      "name": "get_product",
      "outputSchema": null
    },
    {
      "description": "Get the real landed cost of a product from this merchant: goods + shipping + tax for a specific destination, plus a signed `quote_token` the payment path binds to. Call this before paying — the token is what makes the price the MERCHANT's, not one you name. Physical products REQUIRE a `fulfillment` ship-to; without one you get FULFILLMENT_REQUIRED. An unserviceable destination returns UNDELIVERABLE (the merchant's own shipping zones, which Facet cannot waive). REQUIRES IDENTITY: send a Facet KYA as `Authorization: Bearer <kya>` (ES256 JWT from https://issuer.facet.llc, or another issuer in this Terminal's agents.txt KYA-Issuers).",
      "inputSchema": {
        "properties": {
          "fulfillment": {
            "description": "Ship-to destination. REQUIRED for physical products.",
            "properties": {
              "address": {
                "description": "All six fields are required, including `region`.",
                "properties": {
                  "country": {
                    "description": "ISO 3166-1 alpha-2, e.g. US.",
                    "type": "string"
                  },
                  "line1": {
                    "type": "string"
                  },
                  "line2": {
                    "type": "string"
                  },
                  "locality": {
                    "description": "City.",
                    "type": "string"
                  },
                  "phone": {
                    "type": "string"
                  },
                  "postal_code": {
                    "type": "string"
                  },
                  "recipient": {
                    "type": "string"
                  },
                  "region": {
                    "description": "State/province. Required even where the country has none.",
                    "type": "string"
                  }
                },
                "required": [
                  "recipient",
                  "line1",
                  "locality",
                  "region",
                  "postal_code",
                  "country"
                ],
                "type": "object"
              },
              "fulfillment_ref": {
                "description": "Opaque ref from a prior quote (mode `ref`).",
                "type": "string"
              },
              "mode": {
                "description": "`inline` with a full address, or `ref` to reuse a prior fulfillment_ref.",
                "enum": [
                  "inline",
                  "ref"
                ],
                "type": "string"
              }
            },
            "type": "object"
          },
          "product_id": {
            "description": "Product or variant id, e.g. from search_catalog.",
            "type": "string"
          },
          "qty": {
            "description": "Quantity. Default 1.",
            "minimum": 1,
            "type": "integer"
          },
          "site_id": {
            "description": "Usually omitted — this Terminal's bound site is used.",
            "type": "string"
          }
        },
        "required": [
          "product_id"
        ],
        "type": "object"
      },
      "name": "get_quote",
      "outputSchema": null
    },
    {
      "description": "List YOUR order history on this merchant, newest first. Scoped to your own agent identity — you never see another agent's orders. REQUIRES IDENTITY: Facet KYA as `Authorization: Bearer <kya>`.",
      "inputSchema": {
        "properties": {
          "cursor": {
            "description": "Opaque cursor from a previous page.",
            "type": "string"
          },
          "limit": {
            "description": "Max orders to return.",
            "minimum": 1,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "list_orders",
      "outputSchema": null
    },
    {
      "description": "Look up one or more products or variants by identifier (batch).",
      "inputSchema": {
        "properties": {
          "catalog": {
            "properties": {
              "ids": {
                "items": {
                  "type": "string"
                },
                "maxItems": 100,
                "minItems": 1,
                "type": "array"
              }
            },
            "required": [
              "ids"
            ],
            "type": "object"
          }
        },
        "required": [
          "catalog"
        ],
        "type": "object"
      },
      "name": "lookup_catalog",
      "outputSchema": null
    },
    {
      "description": "Request a refund or return on a DELIVERED order you placed on this merchant. Opens a merchant-approved refund ticket (status `requested`); it moves NO money on its own. The merchant reviews and approves it, and only then does the send-back sign from the merchant's OWN wallet (non-custodial). Amount and recipient are NOT inputs: the refund amount is derived and capped server-side, and the recipient is the order's stamped payer, never one you name. Pass `refund_line_items` to refund only part of the order; omit for the whole order. Owner-scoped: another agent's order returns FORBIDDEN. REQUIRES IDENTITY: a Facet KYA as `Authorization: Bearer <kya>` (an ES256 JWT from https://issuer.facet.llc, or another issuer in this Terminal's agents.txt KYA-Issuers). A wallet-bound KYA also authorizes a platform-originated order by its stamped payer.",
      "inputSchema": {
        "properties": {
          "order_id": {
            "description": "The order id returned at payment (settle / checkout complete). A reservation id is not an order id.",
            "type": "string"
          },
          "reason": {
            "description": "Why the refund or return is requested. Required.",
            "type": "string"
          },
          "receipt": {
            "description": "Optional Ed25519-signed settlement receipt (the signed settle response you received). When valid and bound to this order it records receipt_verified on the ticket; it never gates the refund.",
            "properties": {
              "body": {
                "type": "string"
              },
              "path": {
                "type": "string"
              },
              "signature": {
                "type": "string"
              },
              "trace_id": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "refund_line_items": {
            "description": "Optional PARTIAL selection: refund only these lines instead of the whole order. Advisory at request time; the merchant is authoritative and may adjust it at decide. Omit for a full-order refund.",
            "items": {
              "properties": {
                "product_id": {
                  "description": "A product id present in the order.",
                  "type": "string"
                },
                "qty": {
                  "description": "At most the ordered quantity for that line.",
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "required": [
                "product_id",
                "qty"
              ],
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "order_id",
          "reason"
        ],
        "type": "object"
      },
      "name": "post_delivery_refund",
      "outputSchema": null
    },
    {
      "description": "Search the merchant catalog for products matching a free-text query.",
      "inputSchema": {
        "properties": {
          "catalog": {
            "properties": {
              "pagination": {
                "properties": {
                  "cursor": {
                    "type": "string"
                  },
                  "limit": {
                    "minimum": 1,
                    "type": "integer"
                  }
                },
                "type": "object"
              },
              "query": {
                "description": "Free-text search query.",
                "type": "string"
              }
            },
            "type": "object"
          }
        },
        "required": [
          "catalog"
        ],
        "type": "object"
      },
      "name": "search_catalog",
      "outputSchema": null
    },
    {
      "description": "Replace a cart's line items (full replacement), re-priced server-side. Owner-scoped. REQUIRES IDENTITY on a signature-required Terminal.",
      "inputSchema": {
        "properties": {
          "id": {
            "description": "The cart id.",
            "type": "string"
          },
          "line_items": {
            "description": "The new full set of items, each `{ item: { id }, quantity }`.",
            "items": {
              "properties": {
                "item": {
                  "properties": {
                    "id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id"
                  ],
                  "type": "object"
                },
                "quantity": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "name": "update_cart",
      "outputSchema": null
    },
    {
      "description": "Return a checkout's CURRENT sealed snapshot. Facet seals price and items at create, so this is a no-op that reports the session plus a note: to change line items, update the cart and start a new checkout with create_checkout(cart_id). Owner-scoped.",
      "inputSchema": {
        "properties": {
          "id": {
            "description": "The checkout session id.",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "name": "update_checkout",
      "outputSchema": null
    },
    {
      "description": "Save a product to YOUR wishlist on this merchant for later. Idempotent: saving the same product again updates its note and keeps the original save time. Scoped to your own agent identity. REQUIRES IDENTITY: Facet KYA as `Authorization: Bearer <kya>`.",
      "inputSchema": {
        "properties": {
          "note": {
            "description": "Optional short note. No personal data.",
            "type": "string"
          },
          "product_id": {
            "description": "The product id to save.",
            "type": "string"
          }
        },
        "required": [
          "product_id"
        ],
        "type": "object"
      },
      "name": "wishlist_add",
      "outputSchema": null
    },
    {
      "description": "List YOUR saved items (wishlist) on this merchant, newest first. Scoped to your own agent identity, so you never see another agent's list. REQUIRES IDENTITY: Facet KYA as `Authorization: Bearer <kya>`.",
      "inputSchema": {
        "properties": {
          "limit": {
            "description": "Max items to return.",
            "minimum": 1,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "wishlist_list",
      "outputSchema": null
    },
    {
      "description": "Remove a product from YOUR wishlist on this merchant. Idempotent: removing something not on your list succeeds with removed:false. Scoped to your own agent identity. REQUIRES IDENTITY: Facet KYA as `Authorization: Bearer <kya>`.",
      "inputSchema": {
        "properties": {
          "product_id": {
            "description": "The product id to remove.",
            "type": "string"
          }
        },
        "required": [
          "product_id"
        ],
        "type": "object"
      },
      "name": "wishlist_remove",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:46db791e204a65668c915c834028d7b00f7eb31eaf50ef7ffb1db8a58e0296c7 | sha256sum