For the complete documentation index, see llms.txt. This page is also available as Markdown.

Connect via MCP (Beta)

Connect Nifty to ChatGPT, Claude, Gemini, or any other MCP-compatible assistant, then ask about your inventory, orders, and sales in plain English.

Choose your assistant

  • Claude — add Nifty from the Claude connector directory. It always has the latest tools.

  • ChatGPT — add Nifty as a custom connection. The Nifty plugin in the ChatGPT directory is under review and doesn't have the latest tools yet.

  • Gemini — add Nifty as a custom app and use it in Gemini Spark. Requires a Google AI Pro or Ultra subscription.

  • Any other MCP client — add this server URL with OAuth authentication:

https://api.nifty.ai/api/mcp

What you can ask

  • "How many items do I have listed on Poshmark?"

  • "Show me my sales for the last 30 days."

  • "What's my profit and loss for May?"

  • "Itemize the expenses I entered in Analytics for May.

  • "Compare the sell-through rate of my items labeled 'Consignment' vs 'Goodwill'."

  • "Lower the eBay price of my Patagonia fleece to $40."

What the assistant can change

  • Favorite or unfavorite items.

  • Save or update private notes on items.

  • Create, update, and delete labels.

  • Add labels to items or remove them.

  • Edit item titles, descriptions, conditions, quantities, costs, SKUs, listing prices, and each marketplace's category and attributes. Edits to listed items are republished to the marketplaces, usually within 10–15 seconds and rarely up to a minute.

These are the only changes the assistant can make. It cannot create or delete items, change your account settings, or manage your marketplace connections.

Tools

This is the complete list of tools the server exposes. If your assistant is missing one, see Troubleshooting.

Read

  • search_inventory — search inventory by text, SKU, or private notes, with filters.

  • get_inventory_item — full details for one item.

  • get_account_settings — your home country and connected marketplaces.

  • search_categories — search a marketplace's category tree.

  • get_category_attributes — the attributes a category accepts on a marketplace, and which are required.

  • search_attribute_members — the values an attribute accepts, such as brands, colors, or sizes.

  • load_dynamic_attributes — attribute values a marketplace serves live from your connected account.

  • get_item_images — the photos of one item.

  • get_inventory_summary — a snapshot of inventory health.

  • get_labels — your labels.

  • search_orders — order history across marketplaces.

  • get_analytics_overview — sales and profit dashboard for a date range.

  • get_profit_and_loss_report — profit and loss report for a date range.

  • search_expenses — expenses entered or imported in Analytics.

  • get_edit_item_instructions — writing guidelines the assistant loads before editing titles, descriptions, or conditions.

  • get_pending_edits — an item's pending edits.

  • get_action_status — the status of a previously started action.

Write (require a plan with inventory features, see below)

  • edit_item — stage edits to an item's title, description, condition, quantity, cost, SKU, listing prices, or a marketplace's category and attributes.

  • apply_item_edits_action — save an item's pending edits. A draft is saved without being published; a listed item is republished.

  • discard_pending_edits — discard an item's pending edits.

  • set_favorite_action — favorite or unfavorite items.

  • set_private_notes_action — save private notes on items.

  • add_labels_action — add labels to items.

  • remove_labels_action — remove labels from items.

  • create_label_action — create a label.

  • update_label_action — rename or recolor a label.

  • delete_label_action — delete a label.

Requirements

  • A Nifty plan that includes inventory features: Crosslisting Plus, Crosslisting Pro, Bundle Plus, or Bundle Pro.

  • MCP server access turned on under Settings → Experimental in Nifty. If you connect an assistant before turning it on, Nifty will ask you to enable it first.

  • On Claude Team/Enterprise and ChatGPT Business/Enterprise/Edu plans, a workspace admin must enable the Nifty connector (or allow custom connectors) before members can use it.

Troubleshooting

Missing a tool, or a tool that fails with "Tool not found"? New tools are released regularly, and assistants keep the tool list from when you connected. Make sure MCP server access is turned on under Settings → Experimental in Nifty, then follow the troubleshooting steps for Claude, ChatGPT, or Gemini.

Feedback

If something isn't working or you have ideas for what you'd like to see, email [email protected].

Last updated