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
Create an add-to-cart link
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
Create a buy-list link
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