
- Home
- 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) andhttps://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 toolssearch_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.txtandhttps://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| Parameter | Meaning |
|---|---|
| q | words to match in the name, short line, series, brand, category and description |
| category | ai-toys · ip-toys · classic-toys · blind-boxes · diy |
| brand | Aiinlife · Alnkit · Lanxun · Cyber Crystal Spirit · SUPAIPAI · Explore and discover |
| availability | in_stock · out_of_stock · pre_order · backorder |
| min_price, max_price | in the request's currency |
| sort | relevance (default with q) · recommended (default without) · price_asc · price_desc · newest |
| limit, offset | up to 50 per page |
| region | GLOBAL (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.
