FigmoooFigmoooStore
  1. Home
  2. For AI agents

For AI agents

A read-only API for shopping assistants: search the catalogue, read a product, check the policies — then send the customer to the product page to buy.

What this is

Figmooo Store publishes its catalogue for AI shopping agents and assistants in the formats they read today. Everything here is read-only: an agent can find, compare and quote products, prices, stock and policies, but a purchase is always made by the customer on the product page. No key is needed; requests are limited to 120 per minute per address.

  • Merchant feed — https://figmooo.com/agent/feed-my.tsv (RM) and https://figmooo.com/agent/feed-global.tsv (USD): the Google Merchant Center format, which Bing Merchant Center and Meta Commerce Manager also accept as a scheduled fetch — this is how the store appears in Google Shopping, AI Mode, Gemini, Copilot and Meta AI.
  • Catalogue — https://figmooo.com/agent/catalog.json (and .jsonl): every product as a feed item using the OpenAI product-feed field names (item_id, title, description, url, brand, seller_name, image_url, availability, price …), which Google Merchant Center and most feed tools read too.
  • Search — https://figmooo.com/agent/search?q=… with filters for category, availability, price and sort.
  • One product — https://figmooo.com/agent/products/<SKU or slug>.
  • Policies — https://figmooo.com/agent/policies: shipping regions and rates, dispatch, returns, payment.
  • MCP server — https://figmooo.com/agent/mcp: a Model Context Protocol server (Streamable HTTP) with the tools search_products, get_product, get_store_policies, for Claude, ChatGPT, Copilot, Cursor and any MCP client.
  • UCP profile — https://figmooo.com/.well-known/ucp: the Universal Commerce Protocol discovery document (no checkout capability yet).
  • In words — https://figmooo.com/agents.md (the rules), https://figmooo.com/llms.txt and https://figmooo.com/llms-full.txt (the catalogue as markdown), https://figmooo.com/products/<slug>.md (one product).
  • OpenAPI — https://figmooo.com/agent/openapi.json (3.1) for tool-calling frameworks and custom GPT actions.

Search

Plain words in q; every parameter is optional.

GET https://figmooo.com/agent/search?q=talking+panda&category=ai-toys&availability=in_stock&max_price=70&sort=price_asc&limit=10
ParameterMeaning
qwords to match in the name, short line, series, brand, category and description
categoryai-toys · ip-toys · classic-toys · blind-boxes · diy
brandAiinlife · Alnkit · Lanxun · Cyber Crystal Spirit · SUPAIPAI · Explore and discover
availabilityin_stock · out_of_stock · pre_order · backorder
min_price, max_pricein the request's currency
sortrelevance (default with q) · recommended (default without) · price_asc · price_desc · newest
limit, offsetup to 50 per page
regionGLOBAL (default, USD) · MY (RM) · SG · EU · AU · UK — or currency=MYR

The answer: { query, region, currency, total, limit, offset, items: [ …product… ] }.

A product

GET https://figmooo.com/agent/products/FS-AI-111        # by SKU
GET https://figmooo.com/agent/products/aiinlife-cute-fox?region=MY   # by slug, Malaysian price
{
  "item_id": "FS-AI-111", "title": "Cute Fox", "brand": "Aiinlife", "seller_name": "Figmooo Store",
  "url": "https://figmooo.com/products/aiinlife-cute-fox", "image_url": "https://figmooo.com/img/products/…jpg",
  "availability": "in_stock", "inventory_quantity": 3, "price": "45.00 USD", "condition": "new",
  "product_category": "Toys & Games > Plush Toys > AI Companion Toys", "age_group": "toddler",
  "shipping_price": "6.90 USD", "free_shipping_over": "75.00 USD", "accepts_returns": true, "return_deadline_in_days": 14,
  "return_policy": "https://figmooo.com/returns", "is_eligible_search": true, "is_eligible_checkout": false,
  "x_figmooo": { "specs": { … }, "box_contents": [ … ], "ai": { "features": [ … ], "cost_note": "…" }, "markdown_url": "…" }
}

price is always "amount CURRENCY". availability: in_stock ships within 48 hours; out_of_stock; pre_order is charged now and ships on release; backorder is a DIY module confirmed with the customer before shipment. Fields under x_figmooo are the store's own detail beyond the feed standard.

MCP server

Add https://figmooo.com/agent/mcp as a remote MCP server (Streamable HTTP, no authentication). It answers initialize, tools/list and tools/call; each reply is plain JSON.

POST https://figmooo.com/agent/mcp
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_products","arguments":{"q":"owl","region":"MY"}}}

Tools: search_products (same parameters as the search endpoint), get_product (id = SKU or slug), get_store_policies. Results come back as text and as structuredContent.

Rules

  • Read-only. Do not attempt checkout, account or cart actions through /api; they are for the website and are disallowed for robots.
  • Cache the catalogue for up to an hour; search answers for a minute. Quote prices with their currency.
  • To buy, hand the customer the product url. Payment on the site is PayPal.
  • AI toys need a 2.4 GHz Wi-Fi network or a phone hotspot and the maker's app; the AI service terms are per product (x_figmooo.ai.cost_note).
  • Questions: orders@figmooo.com.