MCP App Store
by KeenEthics
Nation icon

Nation MCP Server for ChatGPT

By Autonomous Marketing SF, Inc.

Overview

Nation connects ChatGPT to your Nation store so you can run it from one conversation: catalog, inventory, orders, customers, discounts, reports and the storefront itself. Catalog and inventory: - Search, read, create and update products and collections, change product status in bulk, add products to collections - Read inventory by location and set quantities Orders and customers: - List and read orders and customers - Fulfill or cancel an order when you ask for it Marketing and reporting: - List and create discounts - List and run the store's sales and performance reports Storefront: - Ask the store's site agent to change the storefront, follow its progress and see what changed since the last publish - Publish the storefront, or roll back to an earlier build Every built-in tool has a fixed, typed input for one task. For other store data (blog posts, policies, metaobjects, markets, translations, email campaigns) the app first reads the object's schema with describe_objects, then uses the generic object tools. Read tools only read; tools that overwrite or remove data are marked destructive; tools that contact customers or publish to the internet are marked open world, so ChatGPT asks before running them. The app never moves money. Requires a Nation store. You pick the store when you connect.

How to connect

  1. ChatGPT: Open the Nation listing in the ChatGPT app directory and choose Connect. ChatGPT listing Nation exposes 40 tools here.

Tools

add_products_to_collection

ChatGPT
Add products (by id) to one collection by id or handle, keeping the products already in it. Returns the collection after the change.

bulk_update_product_status

ChatGPT
Set the same status (active, draft or archived) on several products at once, by id. Each product is updated on its own: the result lists { id, ok, error? } per id plus updated and failed counts, so one bad id never blocks the rest.

cancel_order

ChatGPT
Cancel an order that has nothing shipped yet (id = the order id); an order with shipped items cannot be canceled. restock puts its reserved stock back. No money moves: the payment stays captured, and a refund is made by the merchant in the store admin. request_id is a uuid per cancel: a retry with the same request_id cancels once.

create_collection

ChatGPT
Create one collection, optionally with its first products (product_ids). Returns the created collection.

create_discount

ChatGPT
Create one discount: a code or automatic discount on lines, the order or shipping, with a percent (in hundredths of a percent), fixed (minor units) or free value, optional rules, usage limits and dates. It starts as a draft unless status says otherwise. Returns the created discount.

create_objects

ChatGPT
Create one or more objects of a type in one call. Each item is validated on its own: the result lists { ok, id, handle? } or { ok: false, error } per item in order, so a bad entry never blocks the rest, plus created and failed counts.

create_product

ChatGPT
Create one product with its options and variants. It starts as a draft unless status says otherwise. Returns the created product.

delete_object

ChatGPT
Delete one object permanently.

describe_objects

ChatGPT
Schema discovery for one object type of the store: its description, the JSON schemas of its list filters, create fields and update fields (null when the type cannot be created or updated), whether it can be deleted, and every action with its input schema and effect.

fulfill_order

ChatGPT
Mark items of an order as shipped, optionally with tracking, and email the customer when notify_customer is set (id = the order id). Without items it ships everything left. request_id is a uuid per fulfillment: a retry with the same request_id ships once.

get_collection

ChatGPT
Read one collection by id or handle with every field, its product count and the first page of its products.

get_customer

ChatGPT
Read one customer by id with contact details, addresses, marketing consent, tags and note.

get_inventory

ChatGPT
Read one variant's inventory row by variant id: price, SKU and stock overall and per location.

get_object

ChatGPT
Read one object by id or handle with every field.

get_order

ChatGPT
Read one order by id with every field. Amounts are integers in minor units of the order's currency.

get_product

ChatGPT
Read one product by id or handle with every field, its options and its variants.

get_store_info

ChatGPT
Read the store this connection belongs to: name, currency (every money amount of this store is in its minor units), language, logo, fulfillment mode, weight unit and the backup shipping rate.

get_storefront

ChatGPT
Read one site by id. agent { status running | idle, chat_id, last_reply, updated_at } is the site's builder agent for this key's user (null before its first message); unpublished_changes { total, paths, versions } is what changed since the live deployment; live { deployment_id, built_at, preview_url } is what serves the site now (null before the first publish); latest_deployment { id, status, live, error } is the newest build, queued, building, live or failed.

list_customers

ChatGPT
List customers filtered by text (email, name, company, phone) or marketing consent. Returns { rows, total, next }; pass next back as after for the following page.

list_discounts

ChatGPT
List discounts filtered by title or code, status or method (code or automatic). Returns { rows, total, next }; pass next back as after for the following page.

list_inventory

ChatGPT
List variants as inventory rows: product title, SKU, price and stock (on hand, committed, available, and per location), filtered by product title, handle or SKU. Returns { rows, total, next }; pass next back as after for the following page.

list_objects

ChatGPT
List objects of a type with optional filters. Returns { rows, total, next }. total: Rows matching the filters from this page on (after the cursor), this page included. next: Pass it as after to read the next page; null on the last page. A list is paged by a cursor on its own order, so editing rows you already read never skips the rest; to follow every change to a type, read the events list instead; after is a key of filters. The Objects section of your instructions documents every type, its filters and fields.

list_orders

ChatGPT
List orders filtered by order number or customer email, status, payment status, fulfillment status, customer or location. Returns { rows, total, next }; pass next back as after for the following page.

list_reports

ChatGPT
List the store's saved analytics reports with their ids. Returns { rows, total, next }; pass next back as after for the following page.

list_storefront_files

ChatGPT
List the files of a site's code (id = the site id): { files: [{ path, size, updated_at, writable }] }, the same files its builder agent sees. writable is false for the platform's own files, which are read but never written.

list_storefronts

ChatGPT
List the store's sites with their live address, whether a publish is running and their latest deployment. Returns { rows, total, next }; pass next back as after for the following page.

message_storefront_agent

ChatGPT
Send a message to a site's builder agent (id = the site id; message = what to build or change). The agent edits the site's files in the background and never publishes. Returns { chat_id, started: true } as soon as the turn starts; answers 409 while the agent is still working on an earlier message.

publish_storefront

ChatGPT
Put a site live, exactly like the Publish button (id = the site id): it builds the site's current files in the background and returns { deployment_id, status: "queued", live: false }. Answers 409 while the builder agent works or another publish runs. With deployment_id, an earlier ready build of the site, it rolls back to that build instead and returns it live at once. A live site is public on the internet.

query_catalog

ChatGPT
The NationQL catalog of this store: every dataset with its metrics (name, format, level, description), its dimensions and grains, every row dataset with its fields, and the named ranges, compares and chart types the language accepts. Read it before writing a query.

read_storefront_files

ChatGPT
Read files of a site's code (id = the site id; paths = paths of the site's files). Returns { files: [{ path, content } for text, { path, content_base64 } for an image or font], missing, remaining }: remaining are the paths that did not fit this call, read them in the next one.

run_object_action

ChatGPT
Run a named action on one object, for the changes a field patch cannot express. The Objects section lists each type's actions and their input. Returns the object after the action.

run_query

ChatGPT
Run a NationQL query over the store's numbers and answer its result: columns, rows (each with its dimensions, values, previous and change), totals, comparison and meta (currency, time zone, row_count, truncated, sources). A query is FROM <dataset> SHOW <metrics> [WHERE <filter>] [GROUP BY <dimensions> | TIMESERIES <grain>] [HAVING <filter>] [DURING <range> | SINCE <date> UNTIL <date>] [COMPARE TO <compare>] [ORDER BY <field> ASC|DESC] [LIMIT n] [OFFSET n] [VISUALIZE <metrics> TYPE <chart> MAX n]; a row dataset (orders, customers, posts) lists records instead: FROM orders SHOW id, total WHERE status = 'open' ORDER BY total DESC LIMIT 20. Read query_catalog first for the datasets, metrics, dimensions, fields, ranges, compares and charts. An invalid query answers { error, code: query_invalid, issues } with each issue's span and alternatives.

run_report

ChatGPT
Run one saved report by id and return its numbers: the current period rows and totals, and the previous period when the report compares. Money is in minor units, percents are ratios. time_zone (IANA) sets where days are cut; default UTC.

search_collections

ChatGPT
Search the store's collections by text or status. Returns { rows, total, next }; pass next back as after for the following page.

search_products

ChatGPT
Search the store's products by text (title, handle or variant SKU), status or collection. Returns { rows, total, next }; pass next back as after for the following page.

set_inventory

ChatGPT
Set a variant's stock at one or more locations to an absolute quantity (id = the variant id). With compare_quantity, the value previously read, the call answers 409 when stock moved in between and writes nothing at that location.

update_collection

ChatGPT
Change fields of one collection by id or handle. Pass only what changes; products move in and out through add_product_ids / remove_product_ids. Returns the collection after the change.

update_object

ChatGPT
Update fields of one object. Pass only what changes; array fields (tags, images) are replaced whole; memberships move through add_collection_ids / remove_collection_ids on a product and add_product_ids / remove_product_ids on a collection.

update_product

ChatGPT
Change fields of one product by id or handle. Only the fields passed change; arrays (tags, images, variants) are replaced whole, so an array sent without some of its entries drops them, and collection membership moves through add_collection_ids / remove_collection_ids. Returns the product after the change.

write_storefront_files

ChatGPT
Write and delete files of a site's code without its builder agent (id = the site id; files = [{ path, content_base64 }]; delete = paths to remove). One entry in the site's history, like a save in the Code tab; nothing goes live until the site is published. Answers 409 while a builder chat of the site is mid-run. Returns { written, deleted, version_id }.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/nation"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/nation)