generated: '2026-08-12' method: derived status: candidate source: openapi/finditparts-reseller-api-openapi.yml search: official_server_found: false checked: - https://www.finditparts.com/developers - https://api-docs.finditparts.com/ - https://github.com/FinditParts - npm registry (finditparts, @modelcontextprotocol/*finditparts*) - PyPI, RubyGems, Packagist, crates.io, NuGet - web search for a FinditParts MCP server - https://www.finditparts.com/.well-known/ai-plugin.json (404) result: >- FinditParts publishes no hosted, remote or local MCP server, and no agent-facing tool surface of any kind. NOT PUBLISHED BY FINDITPARTS — the tool set below is a candidate derived by API Evangelist from the operations of the Reseller API as a proposal for what an MCP surface would look like. Every tool binds to a real operationId in openapi/finditparts-reseller-api-openapi.yml, so each one's true input schema is that operation's parameters and requestBody. server: null transport: null url: null auth: note: >- Any real server would have to carry the reseller credential server-side, not in the agent. FinditParts requires a fresh HS256 JWT signed with the Reseller Client Secret per request, with iss, exp and — for account pricing and any order action — a sub Customer Reference. An MCP server would sign per call and expose the Customer Reference as a tool argument or as session state. scheme: bearer (reseller JWT or api- key) detail: authentication/finditparts-authentication.yml safety_notes: - >- Six operations place or cancel real commercial orders for heavy-duty parts (completeCartWithCreditCard, completeCartWithCorporateBilling, partnersPlaceOrder, createResellerCustomerSession with NEW_ORDER intent, cancelResellerCustomerSession, addCartLineItem). agentic-access/finditparts-agentic-access.yml classifies these at consequence physical. - >- FinditParts publishes NO idempotency key. A retried checkout tool call can duplicate an order. Any MCP server built on this API must de-duplicate on its own side. - >- errno rides on 200 responses. A tool wrapper that checks HTTP status only will report failures as successes. tools: - name: search_parts description: Search the FinditParts catalog by part number or free-text query, with manufacturer, category, price-range and attribute filters. category: catalog source_operation: openapi/finditparts-reseller-api-openapi.yml#productSearch read_only: true - name: lookup_part_number description: Find products whose part number or cross-reference exactly matches a given part number. category: catalog source_operation: openapi/finditparts-reseller-api-openapi.yml#lookupProductByPartNumber read_only: true - name: get_product description: Get full detail for one product, optionally including PIES data. category: catalog source_operation: openapi/finditparts-reseller-api-openapi.yml#getProduct read_only: true - name: get_products description: Get detail for several products by comma-separated id. category: catalog source_operation: openapi/finditparts-reseller-api-openapi.yml#getProductsMulti read_only: true - name: get_variants description: Look up variant price, account price, stock, ship cutoff and core charge by variant id. category: catalog source_operation: openapi/finditparts-reseller-api-openapi.yml#variantLookup read_only: true - name: quote_shipping description: Quote shipping methods and estimated cost for a set of line items and a destination address. category: shipping source_operation: openapi/finditparts-reseller-api-openapi.yml#shippingMethods read_only: true - name: list_orders description: List the orders on the current user session. category: orders source_operation: openapi/finditparts-reseller-api-openapi.yml#listOrders read_only: true - name: search_orders description: Search orders by query, date range and sort. category: orders source_operation: openapi/finditparts-reseller-api-openapi.yml#searchOrders read_only: true - name: get_order description: Get one order with line items, shipments and payments. category: orders source_operation: openapi/finditparts-reseller-api-openapi.yml#getOrder read_only: true - name: list_addresses description: List the addresses on the current user session. category: addresses source_operation: openapi/finditparts-reseller-api-openapi.yml#listAddresses read_only: true - name: create_cart description: Create a new cart (draft order). category: cart source_operation: openapi/finditparts-reseller-api-openapi.yml#createCart read_only: false - name: get_cart description: Get cart detail including line items, totals and selected shipping. category: cart source_operation: openapi/finditparts-reseller-api-openapi.yml#getCart read_only: true - name: add_to_cart description: Add a product or variant to a cart at a given quantity. category: cart source_operation: openapi/finditparts-reseller-api-openapi.yml#addCartLineItem read_only: false - name: update_cart_line_items description: Change the quantities of existing cart line items. category: cart source_operation: openapi/finditparts-reseller-api-openapi.yml#changeCartLineItems read_only: false - name: get_cart_shipping_methods description: Get the shipping methods available for a cart. category: cart source_operation: openapi/finditparts-reseller-api-openapi.yml#getCartShippingMethods read_only: true - name: select_cart_shipping_method description: Select a shipping method on a cart. category: cart source_operation: openapi/finditparts-reseller-api-openapi.yml#selectCartShippingMethod read_only: false - name: set_cart_shipping_address description: Set the cart shipping address by address id or inline address. category: cart source_operation: openapi/finditparts-reseller-api-openapi.yml#setCartShippingAddress read_only: false - name: set_cart_po_number description: Attach a purchase-order number to a cart. category: cart source_operation: openapi/finditparts-reseller-api-openapi.yml#setCartPoNumber read_only: false - name: create_customer_session description: Create a hosted USER_SETUP or NEW_ORDER session and return the embeddable finditparts.com URL. category: reseller source_operation: openapi/finditparts-reseller-api-openapi.yml#createResellerCustomerSession read_only: false requires_human: true - name: get_customer_session description: Read the status, resolution and resulting order of a hosted session. category: reseller source_operation: openapi/finditparts-reseller-api-openapi.yml#getResellerCustomerSession read_only: true - name: create_reseller_customer description: Create a sub-user on the reseller master account keyed by customer_reference. category: reseller source_operation: openapi/finditparts-reseller-api-openapi.yml#createResellerCustomer read_only: false - name: list_reseller_customers description: List reseller customers on the master account. category: reseller source_operation: openapi/finditparts-reseller-api-openapi.yml#listResellerCustomers read_only: true tool_count: 22 excluded_from_candidate_surface: - operations: [completeCartWithCreditCard, completeCartWithCorporateBilling, partnersPlaceOrder] reason: >- Irreversible commercial checkout with no idempotency contract. Deliberately not proposed as agent tools; route through the hosted NEW_ORDER session where a human confirms, or gate behind an explicit human-in-the-loop step. - operations: [createSession, refreshSession, destroySessions, getCurrentSession, createUser] reason: Credential-handling operations; belong to the server, not the agent tool surface. - operations: [createAddress, updateAddress, deleteAddress, setDefaultAddress, setCartBillingAddress, setCartCoupon, cancelResellerCustomerSession, partnersShippingMethods] reason: >- Available to bind, but omitted from the proposed minimum surface — address mutation, coupon application and order cancellation are account-altering and better handled with explicit confirmation.