Skip to content

API

Developers

The public Itemoo API for ERP, warehouse and production, plus product data for agents and scanners. The docs are generated from the API’s own code.

Your first call in three minutes

  1. In the Itemoo dashboard open Integrations → API keys and create a key with the scopes you need. You will see the key only once.

  2. Check the connection: GET /v1/ping with the header Authorization: Bearer itm_…

  3. Send stock or fetch orders — every endpoint below has an example. Order notifications are set up in the same place of the dashboard.

Create a key in the dashboard →

cURL

curl 'https://itemoo.eu/v1/ping' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

MCP servers for AI assistants

The Model Context Protocol lets AI assistants (Claude, ChatGPT and others) use Itemoo without a custom integration: the assistant discovers the tools and their parameters by itself.

Global MCP — products and shopping

Search for products, brands, companies, sellers and articles, product data with the source of every fact, recalls, documents and a cart with a checkout link. No sign-in. Search covers brands that chose to be listed; the buyer always pays in the brand shop.

Server address

https://itemoo.eu/mcp

Tools

  • search — Search products, brands, companies, sellers and articles
  • brand_get — Brand profile
  • product_lookup — Product data with provenance
  • recall_status — Recall and safety notice status
  • documents_list — Product documents
  • sellers_for_product — Where to buy
  • cart_create — Prepare a cart in a brand shop

Brand MCP — your brand data

Catalogue, batches, scans, compliance gaps, sales and stock in figures, with no personal data of customers. With the brand owner’s separate consent the assistant also creates drafts of product pages, posts, articles, campaigns and the brand website — a person always publishes them in the panel. Every connection belongs to one person in the team and one brand.

Your brand: address in the panel

https://itemoo.eu/mcp/b/{brand}

  1. The brand owner switches it on in the panel under Integrations → AI assistants (MCP) and picks the roles allowed to connect.

  2. In your assistant, add a custom connector with the brand server address shown in the panel.

  3. Sign in to Itemoo and approve access. The assistant sees only what your role allows; you can revoke the connection in the panel.

Tools

  • products_list — Products of the brand
  • products_get — Product details
  • batches_list — Batches (LOT)
  • codes_stats — QR code and unit statistics
  • scans_analytics — Scan analytics
  • plan_usage — Plan and usage
  • catalog_gaps — Catalogue gaps
  • translations_status — Translation status
  • orders_summary — Orders summary
  • customers_summary — Customers summary
  • stock_overview — Stock overview
  • promotions_list — Promotions
  • marketplace_status — Marketplace channels
  • team_overview — Team overview
  • billing_summary — Billing summary
  • product_page_get — Product page draft for editing
  • product_draft_create — Create product drafts
  • product_page_draft_patch — Edit a product page draft
  • site_draft_get — Brand website draft
  • site_draft_patch — Edit the brand website draft
  • publications_list — Social media posts
  • publication_get — One post
  • publication_draft_upsert — Create or edit a post draft
  • articles_list — Knowledge articles
  • article_get — One article
  • article_draft_upsert — Create or edit an article draft
  • campaigns_list — Push and newsletter campaigns
  • campaign_get — One campaign
  • campaign_draft_upsert — Create or edit a campaign draft
  • draft_discard — Discard your own draft

cURL

curl -X POST 'https://itemoo.eu/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"resin"}}}'

Guides

Step by step: connecting your ERP, webhooks, the product passport.

Guides are coming soon.