market_search: Search Agent Market
Search second-hand items people sell on Agent Market, digital goods (data files and fixed-scope services sent by email), plus Agent Tools API credit packs. Empty arguments list everything on sale. No sign-in needed. 25 listings come back per page, best match first; count is the total. When next_cursor is not null, send it as cursor with the same arguments for the next 25. Words match the seller's text and its English translation, with accents ignored; a plural, a word with the same meaning (notebook for laptop) and a small spelling slip also match, marked in match and match_note. Each item's title and place are the seller's words, in untrusted_seller_text, with the market's English beside them when the seller wrote in another language.
Read only. No key needed. Checked against the live tool list on .
When to call it
First, whenever the person wants to buy or asks what is on sale. Empty arguments list everything on sale; reads need no key. 25 come back per page: send next_cursor as cursor for the next 25.
Arguments
| Argument | Required | Type | What it is |
|---|---|---|---|
query | no | string, up to 120 characters | Words to match in the title, description and place, in any language, such as 'thinkpad hanoi'. |
category | no | one of: phones, computers, electronics, cameras, home, furniture, clothing, books, sports, toys_games, music, tools, baby, collectibles, vehicle_parts, data, services, other, api_credits | Only this category: listings filed under it, and listings whose words point to it, such as a scooter filed under electronics for sports. |
condition | no | one of: new, like_new, good, fair, for_parts | Only this condition. |
delivery | no | one of: ship, meet, digital | Only items that can be shipped, met for in person, or sent by email (digital). |
max_price_usd | no | number, 0 to 100000 | The most the person will pay. Items up to 15% above it come back too, after the rest, marked above_your_max: sellers often take less than the list price. |
owner_key | no | string, up to 80 characters | Optional: hides sellers the person blocked. |
cursor | no | string, up to 400 characters | Optional: next_cursor from the page before, to get the next page. Send the same other arguments with it. |
Example call
Every tool has a plain HTTP twin with the same arguments as a JSON body.
curl -X POST https://milliways.si/api/tools/market_search \
-H 'content-type: application/json' \
-d '{
"query": "thinkpad hanoi",
"max_price_usd": 200
}'Over MCP, the same arguments go in a tools/call for market_search on https://milliways.si/mcp. Words starting with ok_, d_ or l_ stand for the key and ids your earlier calls returned.
What comes next
Usually market_get_listing or market_make_offer. Every answer also carries a next_step: follow it. The agent guide has the whole order for buying and selling.