AI Integration is Marzi's MCP server. It does two things: your assistant reads any public Allegro data the moment it needs it — a listing, a category, a seller, a product card with every offer, one offer in full — and it keeps watching that data after the conversation ends, with monitors Marzi runs on its own schedule. Your products, the weekly index and the store analysis come on top.
Any Allegro data, now — search results, categories, storefronts, seller reputation, product cards with every offer, one offer in full, cards by barcode: read as a shopper sees them, in one normalised shape.
The same data, over time — a price, a stock level, a competitor's offer, your own search position: watched on a schedule, with history and an event when your rule fires.
On top: your products and the index — your own list with measured positions, the weekly market index, the store analysis.
Sign in, pay per request — OAuth 2.1 for Claude, ChatGPT and Codex, a personal token for SDKs; 5,000 free requests, cached repeats and failed reads cost nothing.
Recorded in the cabinet on a demo account — real Allegro data
platform.marzi.ai
Data source
8kinds of Allegro page your assistant can read on demand
6kinds of monitor that keep watching after the chat ends
4clients verified end to end: Claude, Claude Code, ChatGPT, Codex — plus the Responses API and MCP SDKs
5,000free requests on every new account; a cached repeat or a failed read costs 0
Why you need it
“I already use an AI assistant. Why does it know nothing about Allegro?”
Without it
Ask Claude or ChatGPT what sells on Allegro and you get a summary of blog posts, not today’s listings.
Every number you want checked means opening the page yourself and pasting it into the chat.
The assistant forgets the moment the chat ends — nothing keeps watching.
With AI Integration
Your assistant reads any Allegro data the moment it needs it — listings, sellers, product cards, offers — as the page shows it now.
It puts the data you care about under watch, and Marzi keeps checking after the chat ends.
Your products, the weekly index and the store analysis come on top of that base.
Real Allegro data when you ask, and watched while you ship
Niche research, price checks, competitor watching, position reports — the assistant does them on today’s Allegro instead of guesses, and keeps the watch running. Pay per request; the first 5,000 are free; a cached repeat or a failed read costs nothing.
How it works
Three steps, the whole product
1
Ask for the data
Your assistant reads Allegro the moment you ask: a search with sort and filters, a category, a seller's storefront and reputation, a product card with every seller on it, one offer at listing depth or in full, a card by barcode. Every card comes in one normalised shape with the page and time it was read.
Live pages, read now — not a summary of the internet
Counters keep their meaning: buyers in 30 days are people, offers are not sellers, a rank is visibility
Unknown is null, never zero
2
Keep watching it
Tell the assistant what to watch — a price, a stock level, a competitor's offer on a card, your own position for a search — with a rule and an interval from one hour to a day. Marzi runs the checks itself, keeps the history and writes an event only when the rule fires.
Six kinds of monitor; list, edit, pause, resume, delete them in words
History stays even when the assistant is closed
Each scheduled check is one request on the meter
3
Connect, choose, meter
Copy the endpoint into Claude, ChatGPT or the Codex CLI and sign in when the browser opens; SDKs carry a personal token shown once. The wizard lists every function with a plain name — what is switched off is refused at the server — and the dashboard shows what was called, when and what it cost.
One endpoint, Streamable HTTP, OAuth 2.1 — no client id or secret
Functions on or off per account; a daily spend cap you set
Requests by day and function; paid, trial, cached and failed apart
What is inside
Built from what Allegro actually shows
Every figure on the screen has the page it was taken from and the method printed next to it. These are the parts.
Any Allegro data, on demand
Search results with sort, filters and a cursor; category and seller listings; a seller's reputation; product cards with every offer, price with delivery, stock and buy box; a card by barcode; one offer in full — stock, GTIN, rating distribution, reviews by feature, description, warranty, returns. Read as a shopper sees them now, in one normalised shape.
The same data, over time
Watch a price, a stock level, a competitor's price or stock on a card, or your own search position — with a rule and an interval from an hour to a day. Marzi runs the checks on its own schedule, keeps the history and writes an event when the rule fires; the assistant reads events back and you see them under the bell.
On top: your products and the index
Your own list with the positions Keyword Tracker measures, and the weekly market index for sizing a niche — answered from Marzi's database, without opening Allegro.
On top: store analysis
The tracked products, their cards and positions turned into prioritised findings with the evidence quoted by field — a deterministic read, not a model's opinion.
OAuth 2.1 and personal tokens
Chat clients sign in through the browser; scripts carry a personal token that is shown once and stored as a hash. Anything not switched on in the wizard is refused by the server.
Metered, with a floor of zero
Every request is one line with its price at the moment of the call. A cached repeat and a failed read cost nothing; trial requests come first, then the prepaid balance, then the daily cap you set.
Clients
The assistants that already read Allegro through Marzi
In colour: connected and verified end to end, with the setup steps in the cabinet. In grey: on the way — any client that speaks MCP over Streamable HTTP with a bearer token works today; these get their own guide once we have tested them ourselves.
Connected and verified
ClaudeDesktop and claude.ai · custom connector, OAuth sign-in
Claude CodeCLI · claude mcp add --transport http
ChatGPTCustom app in developer mode · Pro, Business, Enterprise/Edu (not Plus) · web only
CodexCLI · codex mcp add, OAuth or personal token
OpenAI Responses APIMCP tool in the request, with a personal token
Any MCP clientStreamable HTTP and a bearer token — the official SDKs in Python and TypeScript
Coming soon
Perplexitycoming soon
Google Geminicoming soon
Ollamacoming soon
Two pillars, plus additions
What your assistant can call
Allegro data on demand and the same data tracked over time are the base; your products, the index and the store analysis come on top. Each function is switched on or off in the cabinet; what is off is refused at the server. Every answer carries the source page and the time it was read.
Allegro data on demand 8
Live reads of Allegro’s public pages — what a shopper sees right now. Listings are cached for ten minutes, offers for an hour.
Search Allegrolistings by query, filters, and sort, with a cursor
Browse a categorythe selling cards inside a category with sales data
Browse a seller’s offerseverything one seller lists
Seller profilerating, Super Seller status, age, delivery terms
Find by barcodeA card by GTIN or EAN
Product cardprice, buyers, rating, stock and GTIN of an offer
Full product detailsparameters, gallery, description, reviews, warranty, returns
Competing offerseveryone who sells the same product, with price and delivery
Tracking over time 7
The same facts, watched on Marzi’s side after the conversation ends — from every hour to once a day.
Watch a pricealert when a card’s price moves past your threshold
Watch stockalert on a drop below N or a restock
Watch a search positionalert when your card leaves the top N
Watch a competitoralert on a competitor’s price, listing or promo change
Custom monitoryour own rule for any function, at your own interval
Monitor eventswhat a monitor found, with the readings
On top: Marzi intelligence 3
Answers from Marzi’s own database — fast, without opening Allegro, as fresh as the last measurement.
Market overviewthe weekly index for a category over 30 days
My productsyour own cards as the index sees them.
My search positionsthe positions Keyword Tracker measures for your keywords
On top: store analysis 1
Your tracked products, their cards and positions turned into prioritised findings with the evidence quoted.
Store analysisproblems and opportunities per product, with the facts they rest on
ChatGPT 2
The pair every ChatGPT connector needs.
Searchten results by relevance, with IDs
Open a resultthe offer behind a result ID
In plain words
What people ask
No function names, no parameters. The assistant picks the call; Marzi opens the page, extracts the figures and hands them back as data — and checks that the digits in the answer are the digits it returned.
Find nitrile gloves under 40 zł sorted by popularity.
What sells best in this category: https://allegro.pl/kategoria/…
Who else sells this product and at what price with delivery?
How big is the market for foam rollers this month?
Where does my offer rank for ‘buty męskie’?
Analyse this store and show the five cards that need attention.
Tell me when this offer’s price changes by more than 5%.
Alert me if my product falls out of the top 10 for ‘rękawiczki’.
Check this card every 6 hours and alert me if a new seller appears.
What did watcher #12 find this week?
5,000free requests on every new account, used before the balance
1 call = 1 requestwhatever the size of the response, a monitor’s scheduled check is one request too
0for a cached repeat — a listing within 10 minutes, an offer within an hour — and for a failed read
Your capa daily limit you set yourself; when it is reached, calls are refused until tomorrow
Control
What the assistant may do, and what it may not
Read-only
every function reads public pages or Marzi’s data; nothing is written to Allegro
Only allegro.pl
every link is classified before it is opened; anything else is refused
OAuth 2.1 for chat clients
sign in through the browser; no client id, no secret, no key to paste
Personal token for scripts
shown once, stored as a hash, rotated from the cabinet in one click
Off means off
a function switched off in the cabinet is refused at the server, whatever the client asks
Every request shown on the meter
priced at the moment of the call; the counting rule is shown in the cabinet
Connect
One endpoint for every verified client
The same server behind Claude, ChatGPT, Codex, the OpenAI Responses API and any MCP SDK. Chat clients sign in through the browser; scripts carry a personal token from the cabinet.
claude mcp add --transport http marzi https://mcp.marzi.ai/mcp
# sign in when the browser opens, then /mcp to see the tools
# Settings → Connectors → Add custom connector
Name: Marzi for AI
URL: https://mcp.marzi.ai/mcp
Auth: OAuth — no client id, no secret
codex mcp add marzi --url https://mcp.marzi.ai/mcp
codex mcp login marzi
# or ~/.codex/config.toml with a personal token
[mcp_servers.marzi]
url = "https://mcp.marzi.ai/mcp"
bearer_token_env_var = "MARZI_MCP_TOKEN"
Marzi says which is which on the screen itself. Here is the short version for AI Integration.
Measured
What a function returns is one normalised schema per card — price, delivery, seller, popularity, rating, offer count — with the source page and time.
Every request is metered as it happens, with the price at the moment of the call.
A watcher runs on Marzi's side and keeps running after the client disconnects.
Estimated or limited
Clients listed are the ones connected and verified end to end; Perplexity, Gemini and Ollama are on the way and not promised until they are.
A seller's storefront by popularity is read to page one only — Allegro blocks the deeper pages deterministically, and the server says so instead of retrying.
Payment is by invoice: top up through the cabinet, Marzi credits the balance once it is paid. There is no card form yet.
Who it's for
Three ways to use AI Integration
Starting out
Ask what sells in a category, who sells a product and at what price with delivery, what a card's stock and buy box look like — and get the page's numbers, not a summary of the internet.
Already selling
Put the data you care about under watch — competitors' prices and stock, your own positions — and let the assistant tell you what moved while you were shipping.
Brands and agencies
Wire Allegro into your own agents through the Responses API or an MCP SDK, with one token per account and a meter you can read.
FAQ
questions about AI Integration
What data can the assistant get?
Any public Allegro page, read the moment it is asked: a search with sort and filters, a category, a seller's storefront and reputation, a product card with every seller, price with delivery, stock and buy box, one offer at listing depth or in full, a card by barcode. Facts as Allegro shows them, with the time they were read; unknown is null, never zero.
What can it keep watching?
Any of those facts: an offer's price or stock, a competitor's price or stock on a card, your own organic position for a search. A rule and an interval from an hour to a day; Marzi runs the checks itself, keeps the history and records an event when the rule fires.
Which clients are supported?
Claude (custom connector) and Claude Code, ChatGPT (a custom app in developer mode — on Pro with read/fetch, which is all Marzi needs, and on Business and Enterprise/Edu; Plus and Free cannot connect one), the Codex CLI, the OpenAI Responses API and any MCP SDK with Streamable HTTP and a bearer token. The wizard shows the steps and the config for each. Clients we have not connected ourselves are not on the list.
How does sign-in work?
Chat clients use OAuth 2.1: paste the endpoint, a Marzi page opens, you sign in, done — no client ID or secret. Scripts and SDKs use a personal token generated in the cabinet; it is shown once and can be rotated.
What does a request cost?
The account's rate per 1,000 requests, applied at the moment of the call. New accounts start with 5,000 free requests. A cached repeat — the same listing within 10 minutes, the same offer within an hour — and a failed read cost nothing.
What is a monitor?
A watcher the assistant creates in words — a link, a rule, an interval from one hour to a day. Marzi checks it on schedule and records an event when the condition is met; the assistant reads events back, and you see them under the bell in the cabinet. Each scheduled check is one request.
Can I limit what the assistant may do?
Yes, twice. The wizard switches individual functions on or off, and the server refuses what is off. The daily limit caps spend per day; when it is reached, calls are refused until tomorrow.
Does it write anything to Allegro?
No. Every function is read-only: it reads public pages or Marzi's own data. Monitors are stored in Marzi, not on Allegro.