Tools

This page is generated from the tools the server offers. Each tool shows what it does, whether it changes anything, whether it asks the assistant to confirm each call with you, and the permission it needs. You choose permissions when you connect an assistant; see Connect an assistant.

In Claude and ChatGPT, a tool marked as showing a card shows its result as a card with images and buttons. Every tool answers in text as well.

No tool pays for anything or transfers money. Four order actions have payment consequences that CardNexus processes under its terms, as when you take them on cardnexus.com: cancel_sale and accept_cancellation_request lead to a full refund to the buyer, confirm_receipt makes the seller's payout eligible, and withdraw_dispute closes a dispute without a refund.

Catalogue and prices

Read the catalogue, prices and the Marketplace. These tools need no permission beyond signing in.

Search cards and sealed products

search_products

Searches CardNexus cards and sealed products by name, set code, print number, game, type and game attributes. Results include the market price and the marketplace price, and with a delivery country the cheapest copy that ships there.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: None beyond signing in
  • Shows a card: Yes, the Products card, in assistants that show cards

Get product details and prices

get_products

Returns up to 200 products by id: name, set, print number, finishes, market price per region and the marketplace price with listing counts, and with a delivery country the cheapest copy that ships there.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: None beyond signing in
  • Shows a card: Yes, the Products card, in assistants that show cards

See who sells a product

get_product_listings

Lists the live CardNexus listings of one product, cheapest first by default, with condition, language, finish, quantity, photo count, seller rating, price compared with market price and the shipping charge to the user's delivery country.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: None beyond signing in
  • Shows a card: Yes, the Listings card, in assistants that show cards

Search listings

search_listings

Searches live CardNexus listings across products by name, game, set, price, price compared with market price, condition, language, finish, grading, seller and delivery country, sorted by price, price compared with market price or newest. Each listing has the seller's rating, its photo count and a cardnexus.com link.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: None beyond signing in
  • Shows a card: Yes, the Listings card, in assistants that show cards

Browse games and sets

browse_sets

Lists the games on CardNexus, or one game's sets newest first, with release dates, card counts and a link to each set's page. Set ids filter product and listing search.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: None beyond signing in
  • Shows a card: Yes, the Products card, in assistants that show cards

View a seller

get_seller

Returns a CardNexus seller's public profile by username: country, seller type, member since, rating, verified sales, recent completion rate and shipping time, and whether they take orders. The username is chosen by the seller.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: None beyond signing in
  • Shows a card: Yes, the Listings card, in assistants that show cards

build_cart_link

Builds a cardnexus.com link to a page that shows up to 200 chosen listings with their current price and an add-to-cart button. Opening the link changes nothing; the person adds the listings and pays on cardnexus.com, with or without an account.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: None beyond signing in
  • Shows a card: No, the answer is text

Price history

get_price_history

Returns one product's daily market price history per region and finish, for up to 365 days. Long ranges are reduced to weekly or monthly points.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: None beyond signing in
  • Shows a card: Yes, the Product and price history card, in assistants that show cards

Plan the cheapest basket

plan_basket

Finds the cheapest, fewest-seller and balanced ways to buy up to 400 cards across CardNexus sellers, shipping included. Returns the options with totals, or a plan id that get_job reads when the calculation outlasts the wait. Nothing is added to the cart.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: None beyond signing in
  • Shows a card: Yes, the Basket plan card, in assistants that show cards

build_buy_list_link

Builds a cardnexus.com link that opens the cart wizard with up to 400 products and their quantities already entered. The link holds the list itself and opens without signing in.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: None beyond signing in
  • Shows a card: No, the answer is text

Cart

Permission group: Cart. Tools that only read need "View your cart"; tools that change something need "View and modify your cart".

View your cart

get_cart

Shows the user's CardNexus cart by seller, with the delivery country, item prices, each seller's shipping charge and a link to review and pay on cardnexus.com.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Cart: view only
  • Shows a card: Yes, the Cart card, in assistants that show cards

Add listings to your cart

add_to_cart

Adds listings to the user's CardNexus cart by listing id and quantity. Each item succeeds or fails separately; payment is made on cardnexus.com.

  • Changes anything: Yes. It adds new data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Cart: view and change
  • Shows a card: Yes, the Cart card, in assistants that show cards

Change or remove item

update_cart_item

Sets the quantity of a listing in the user's CardNexus cart; 0 removes it. Lowering or removing items of an accepted offer voids that offer.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Cart: view and change
  • Shows a card: Yes, the Cart card, in assistants that show cards

Apply basket to cart

apply_basket_plan

Replaces the user's CardNexus cart with one option of a finished basket plan and returns the cart with a link to pay on cardnexus.com. Accepted offers whose items leave the cart are voided.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Cart: view and change
  • Shows a card: Yes, the Cart card, in assistants that show cards

Lists

Permission group: Lists. Tools that only read need "View your lists"; tools that change something need "View, create, and edit your lists".

List your lists

list_lists

Lists the user's CardNexus lists (want lists, decks and for-sale lists) with game, status, card count and completion percentage. get_list returns a list's cards.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Lists: view only
  • Shows a card: No, the answer is text

View a list

get_list

Returns one CardNexus list with its settings and a page of its cards, with the quantity wanted and the quantity the user holds; can return only the cards still missing.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Lists: view only
  • Shows a card: No, the answer is text

Create a list

create_list

Creates an empty CardNexus list (want list, deck, for-sale list or hold list) for one game. Lists are private unless made public.

  • Changes anything: Yes. It adds new data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Lists: view and change
  • Shows a card: No, the answer is text

Add cards to a list

add_list_items

Adds cards to a CardNexus list by product, finish and language. A card already in the list has its quantity replaced by the quantity given.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Lists: view and change
  • Shows a card: No, the answer is text

Remove card from list

remove_list_item

Removes one card line from a CardNexus list by its line id; the rest of the list is kept.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Lists: view and change
  • Shows a card: No, the answer is text

Offers

Permission group: Offers. Tools that only read need "View your sent and received offers"; tools that change something need "View, send, and respond to your offers".

List your offers

list_offers

Lists the user's CardNexus offers, sent and received, newest first, with the current proposal, whose turn it is, and the next steps available.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Offers: view only
  • Shows a card: No, the answer is text

View an offer

get_offer

Returns one CardNexus offer with its negotiated items, every proposal in order, and the steps the user can take next.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Offers: view only
  • Shows a card: No, the answer is text

Make an offer

make_offer

Sends a seller an opening offer on one or more of their listings, as a total price or a discount of at most 40%. The original subtotal must be at least 20 in the listing currency; five opening offers can be sent per hour.

  • Changes anything: Yes. It adds new data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Offers: view and change
  • Shows a card: No, the answer is text

Counter an offer

counter_offer

Proposes a different total on an open CardNexus offer, in reply to the other party's current proposal. A newer proposal makes the call fail without sending anything.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Offers: view and change
  • Shows a card: No, the answer is text

Accept an offer

accept_offer

Accepts the other party's current proposal on a CardNexus offer. The agreed total is fixed and the buyer has 48 hours to add it to the cart.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Offers: view and change
  • Shows a card: No, the answer is text

Decline an offer

decline_offer

Declines the other party's current proposal on a CardNexus offer and closes the offer.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Offers: view and change
  • Shows a card: No, the answer is text

Cancel an offer

cancel_offer

Withdraws the user from an open CardNexus offer. Closed offers cannot be cancelled.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Offers: view and change
  • Shows a card: No, the answer is text

Add offer to cart

add_offer_to_cart

Adds an accepted, unexpired CardNexus offer's items to the buyer's cart at the agreed quantities and total, and returns the cart with a link to pay on cardnexus.com.

  • Changes anything: Yes. It adds new data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Offers: view and change; also Cart: view and change
  • Shows a card: Yes, the Cart card, in assistants that show cards

Inventory

Permission group: Inventory. Tools that only read need "View your inventory"; tools that change something need "View, add, edit, and remove your inventory".

Search inventory

search_inventory

Searches your inventory by card, set, print number, labels, condition, language, finish, sale state, quantity, sale price, market price, price compared with market price, market movement, price check group and last change time, or by line ids. Pages with a cursor; the first page has an exact total. Each line includes its market price and, for listed lines, how far the sale price is from it. Market price filters, the market sorts and price check groups are slower on very large inventories.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Inventory: view only
  • Shows a card: No, the answer is text

Add inventory items

add_inventory_items

Adds cards to your collection by product, finish, language and condition or grading, with optional custom id, notes, location and tags. A card matching an existing line adds to that line's quantity.

  • Changes anything: Yes. It adds new data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Inventory: view and change
  • Shows a card: No, the answer is text

Update inventory items

update_inventory_items

Changes up to 200 inventory lines: quantity, condition, language, finish, notes, location, tags and sale price. Setting a sale price lists or reprices a line; clearing it takes the line off sale. Sale prices more than 60 percent under the market price are held back for the user to set on cardnexus.com.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Inventory: view and change
  • Shows a card: No, the answer is text

Delete inventory items

delete_inventory_items

Permanently deletes up to 200 named inventory lines whatever their quantity, and cancels their listings. Deleted lines cannot be restored. Repeating the call is safe: a line that is already gone counts as deleted.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: Yes
  • Permission needed: Inventory: view and change
  • Shows a card: No, the answer is text

Preview a bulk edit

preview_inventory_edit

Counts the inventory lines that match a filter or id list and shows what one bulk action would do to them, with a sample, warnings and a plan id. Actions: set quantity, delete, remove from sale, set condition, set language, set or clear location, comment or notes, add or remove tags. Nothing is changed. The plan is valid for 24 hours.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Inventory: view only
  • Shows a card: No, the answer is text

Apply a bulk edit

apply_inventory_edit

Applies a previewed bulk edit to the lines the selection matches now, as a background job, and returns the result or a job id. Lines sold or changed since the preview are skipped; if more lines match than were previewed nothing is changed. Deleting cannot be undone.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: Yes
  • Permission needed: Inventory: view and change
  • Shows a card: No, the answer is text

Create an import upload

create_inventory_import_upload

Creates a 15-minute upload address for one inventory file (CSV, JSON or gzip, up to 256 MiB), which takes the file in a single request, and returns the link to the importer on cardnexus.com. The address can write only that one file. Without a size only the importer link is returned.

  • Changes anything: Yes. It adds new data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Inventory: view and change
  • Shows a card: No, the answer is text

Start an inventory import

start_inventory_import

Starts a background import of an uploaded inventory file, in CardNexus CSV or JSON format or one of three stock-file formats, and returns the job. It adds or updates the lines in the file and removes none. Quantities and prices in the file overwrite the current ones.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: Yes
  • Permission needed: Inventory: view and change
  • Shows a card: No, the answer is text

Start an inventory export

start_inventory_export

Starts a background export of your inventory, optionally filtered, as CSV or JSON in the layout the importer reads, and returns a link to a cardnexus.com page where the signed-in user downloads the file. One export can start every 10 minutes.

  • Changes anything: Yes. It adds new data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Inventory: view and change
  • Shows a card: No, the answer is text

Get an inventory summary

get_inventory_summary

Returns the number of inventory lines and cards, how many are listed for sale, the value at market price in EUR and USD, a breakdown by game, and the daily or weekly history of the total value over a chosen period. Lines without a market price count as zero value. Listed cards and the asking value count the full owned quantity of each listed line.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Inventory: view only
  • Shows a card: No, the answer is text

Listings

Permission group: Listings. Tools that only read need "View your listings"; tools that change something need "View, publish, and update your listings".

Get the price check

get_price_check

Shows how your listed cards are priced against their market price, in six groups with card counts, listed value and money at stake, plus the cards worth listing. The summary is the last stored check with its time; passing a group lists the cards in it. Not available to every seller.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Listings: view only
  • Shows a card: No, the answer is text

Preview a reprice

preview_reprice

Counts or drafts a price change for a set of listed cards: sell fast, market price, a percentage from market price, or a percentage from the current price, with a floor and a direction. A seller has one draft at a time and a new draft replaces the earlier one. Nothing is written until the draft is applied.

  • Changes anything: Yes. It adds new data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Listings: view and change
  • Shows a card: No, the answer is text

Get reprice changes

get_reprice_changes

Reads a reprice run: the draft's changes by tab and sort, the results after an apply or undo, or your recent runs when no run id is given. Rows show the current price, the new price and the market price.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Listings: view only
  • Shows a card: No, the answer is text

Exclude cards from reprice

exclude_from_reprice

Leaves cards, or a whole set, out of a ready reprice draft so their prices stay as they are, or puts them back. Returns the updated draft summary.

  • Changes anything: Yes. It adds new data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Listings: view and change
  • Shows a card: No, the answer is text

Apply a reprice

apply_reprice

Writes the prices of a ready reprice draft exactly as reviewed, in the background, and returns the result or a job id. Cards that sold or changed price after the review are skipped. The run can be undone for 7 days. A price rise removes the card from buyers' carts.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: Yes
  • Permission needed: Listings: view and change
  • Shows a card: No, the answer is text

Undo a reprice

undo_reprice

Restores the previous prices of an applied reprice within 7 days. Cards sold, merged or repriced since are not restored and are reported with the reason. Undoing a price cut raises the price, which removes the card from buyers' carts.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: Yes
  • Permission needed: Listings: view and change
  • Shows a card: No, the answer is text

Sales

Permission group: Sales. Tools that only read need "View your sales"; tools that change something need "View and manage your sales".

List your sales

list_sales

Lists the orders you sold, newest first or by earliest ship-by deadline, with status, ship-by date, buyer username, destination city and country, items, subtotal and the actions available on each. Filters: status, needs action, dispute state, ship-by range, buyer, order number prefix and placed date range.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Sales: view only
  • Shows a card: No, the answer is text

Get a sale

get_sale

Returns one order you sold: items, seller fee and payout, shipping and tracking, and cancellation details. The buyer's street address and phone number are not included.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Sales: view only
  • Shows a card: No, the answer is text

Mark orders as shipped

mark_orders_shipped

Marks one or more orders you sold as shipped and registers their tracking numbers. Returns counts and the orders that failed; large batches continue as a job. Orders whose shipping CardNexus manages are shipped by their label instead. Starts payout and dispute clocks.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: Yes
  • Permission needed: Sales: view and change
  • Shows a card: No, the answer is text

Correct a tracking number

update_order_tracking

Replaces the tracking number of an order you shipped, with a reason. Allowed only before the carrier's first scan, within 30 days of shipping, at most twice per order and 15 minutes apart, and not on orders whose label CardNexus created. Returns the updated order.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Sales: view and change
  • Shows a card: No, the answer is text

Cancel a sale

cancel_sale

Cancels an order that has not shipped and refunds the buyer in full. The seller receives an automatic 1-star review and the order counts against the completion rate; stock returns to inventory unless the reason is that the item is unavailable. Cannot be undone.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: Yes
  • Permission needed: Sales: view and change
  • Shows a card: No, the answer is text

Accept a cancellation request

accept_cancellation_request

Accepts a buyer's request to cancel an order that has not shipped. The buyer is refunded in full and the stock returns to inventory; there is no review or completion-rate penalty for the seller. Cannot be undone.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: Yes
  • Permission needed: Sales: view and change
  • Shows a card: No, the answer is text

Get shipping label options

get_shipping_options

Lists the carrier services available for an order whose shipping CardNexus manages, with delivery type, drop-off or pickup and signature on delivery. Prices are not shown because the seller is not charged for the label.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Sales: view only
  • Shows a card: No, the answer is text

Create a shipping label

create_shipping_label

Creates the carrier label for an order whose shipping CardNexus manages, from a method returned by the shipping options. The seller is not charged; the label is printed from the order page, and the order becomes shipped at the carrier's first scan.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: Yes
  • Permission needed: Sales: view and change
  • Shows a card: No, the answer is text

Get a sales summary

get_sales_summary

Returns your to-do counters (orders to ship, in transit, needing action, unread order conversations, payout awaiting transfer) and, for a chosen period, totals and an optional time series of orders, cards sold, revenue, refunds, seller fees and net. Amounts are in your selling currency. The wallet balance is included when the connection has financial access.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Sales: view only
  • Shows a card: No, the answer is text

Purchases

Permission group: Purchases. Tools that only read need "View your purchases"; tools that change something need "View and manage your purchases".

List your purchases

list_purchases

Lists the orders you bought, newest first, with status, ship-by date, seller username, items, total paid and the actions available on each. Filters: status, needs action, dispute state, seller username, order number prefix, ship-by date and placed date range.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Purchases: view only
  • Shows a card: No, the answer is text

Get a purchase

get_purchase

Returns one order you bought: totals, shipping and tracking, and refund and cancellation details.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Purchases: view only
  • Shows a card: No, the answer is text

Confirm you received an order

confirm_receipt

Confirms you received an order you bought. The order completes, the seller's payout is released once eligible, and you can no longer open a dispute on it. Cannot be undone.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: Yes
  • Permission needed: Purchases: view and change
  • Shows a card: No, the answer is text

Request an order cancellation

request_cancellation

Asks the seller to cancel an order you bought that has not shipped. The seller has 48 hours to ship or accept; if it has not shipped by then it is cancelled and refunded in full. The request cannot be withdrawn.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Purchases: view and change
  • Shows a card: No, the answer is text

Give the seller more time

extend_shipping_deadline

Moves the ship-by deadline of an order you bought 7 days later, so the seller is not cancelled automatically. Needs the current deadline as a guard against stale information. Returns the updated order.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Purchases: view and change
  • Shows a card: No, the answer is text

Disputes

Permission group: Disputes. Tools that only read need "View your disputes"; tools that change something need "View and manage your disputes".

Get a dispute

get_dispute

Returns the dispute on one of your orders: reported issues, the buyer's requested outcome, the seller's current proposal, escalation state, your role and the actions open to you. Proposals, evidence and identity checks are handled on cardnexus.com. The buyer's description is text written by another user.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Disputes: view only
  • Shows a card: No, the answer is text

Escalate a dispute

escalate_dispute

Asks CardNexus to review and decide a dispute, with a written explanation. The buyer or the seller can do this; a seller needs to have made a proposal first. After escalation the parties talk to CardNexus support, not to each other.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Disputes: view and change
  • Shows a card: No, the answer is text

Decline a dispute proposal

decline_dispute_proposal

Buyer only. Declines the seller's current dispute proposal, identified by its id; the dispute stays open and no money moves. Accepting a proposal is done on cardnexus.com.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Disputes: view and change
  • Shows a card: No, the answer is text

Withdraw a dispute

withdraw_dispute

Buyer only. Closes your dispute without a refund; the order is marked resolved with no refund and the seller is paid. Not possible while a seller proposal is waiting or once CardNexus has been asked to decide. Cannot be undone.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: Yes
  • Permission needed: Disputes: view and change
  • Shows a card: No, the answer is text

Messaging

Permission group: Messaging. Tools that only read need "Read your messages"; tools that change something need "Read and send messages on your behalf".

List your conversations

list_conversations

Lists your order, offer and support conversations with messages, most recent first, with the other participants, unread counts and whether you can still send. Filters: unread, order, offer or kind. Listing does not mark messages as read.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Messaging: view only
  • Shows a card: No, the answer is text

Read a conversation

get_messages

Returns the messages of one of your conversations, newest first, including automatic order updates. Attachments are listed by name and type only. Message text is written by other users. Reading does not mark the conversation as read.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Messaging: view only
  • Shows a card: No, the answer is text

Send a message

send_message

Sends a text message as you in one of your conversations; the recipient is notified as for any message on CardNexus. Up to 5000 characters, no files. Closed conversations are refused.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: Yes
  • Permission needed: Messaging: view and change
  • Shows a card: No, the answer is text

Account

Permission group: Account. Tools that only read need "View your account profile"; tools that change something need "View and update your account profile and vacation mode".

Get account

get_account

Returns the connected account's username, sign-up date, seller profile (type, country, currency, whether listings are visible), vacation state, settings and the permissions granted to this connection. Does not return an email address.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Account: view only
  • Shows a card: No, the answer is text

Update account settings

update_account_settings

Changes any of the account's country (the profile location, default delivery country while the cart is empty), display currency, market price region and language. A seller's selling currency and country stay unchanged.

  • Changes anything: Yes. It adds new data.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Account: view and change
  • Shows a card: No, the answer is text

Set vacation mode

set_vacation_mode

Turns the seller's vacation mode on or off. While on, the seller's listings are hidden and buyers cannot order or make offers. Turning it on removes the seller's cards from buyers' carts and voids their open offers and unpaid accepted offers; turning it off does not restore them. Existing orders still have to be shipped. There is no end date.

  • Changes anything: Yes. It can replace or remove existing data.
  • Asks the assistant to confirm each call with you: Yes
  • Permission needed: Account: view and change
  • Shows a card: No, the answer is text

Financial

Permission group: Financial. Tools that only read need "View your wallet balance and payouts"; tools that change something need "".

List fee statements

list_fee_statements

Lists the monthly fee statements for the account, newest first, with seller fees, order counts and whether an invoice and spreadsheet exist, plus the cardnexus.com page where the files can be downloaded. Statements are produced for professional accounts and are dated by payout, so they differ from sales totals dated by order.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: Financial: view only
  • Shows a card: No, the answer is text

Jobs

Read the result of a calculation that was still running when the assistant asked for it. No permission beyond signing in.

Get a job

get_job

Reads the state, progress and result of a job another tool started: a basket search (plan id), an inventory import, export or bulk edit, a repricing run or a shipment batch. Waits up to 20 seconds for it to finish or become ready. include: failures pages the failed rows. Reading does not start the work again.

  • Changes anything: No, it only reads.
  • Asks the assistant to confirm each call with you: No
  • Permission needed: None beyond signing in
  • Shows a card: No, the answer is text