{"id":"xyz.rubenayla.partle/marketplace","slug":"xyz-rubenayla-partle-marketplace","title":"Partle","description":"Search products in nearby stores. Agents can also list items for sale on a user's behalf.","version":"1.2.0","publisher":{"kind":"domain","id":"partle.rubenayla.xyz","label":"partle.rubenayla.xyz","url":"https://partle.rubenayla.xyz"},"website":"https://partle.rubenayla.xyz","repository":"https://github.com/rubenayla/partle-mcp","remotes":[{"type":"streamable-http","url":"https://partle.rubenayla.xyz/mcp/"}],"packages":[],"published":"2026-05-10","updated":"2026-05-10","status":"online","auth":"","latency_ms":1637,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"search_products","title":"Search products","description":"Search Partle's product catalog by name or description.\n\n    CRITICAL SEARCH INSTRUCTION: Reason from the job to the product class first, \n    then search with a descriptive product phrase (e.g. including substrate, material, \n    or size class). DO NOT blindly search using the user's raw conversational words. \n    Transform questions like 'what do I need to attach a mirror to a brick wall?' \n    ","read_only":true},{"name":"get_product","title":"Get product details","description":"Get the full record for a single product by its numeric ID.\n\n    Use after `search_products` returns a candidate the user is interested in,\n    when you need fields not in the search summary (full description, all\n    images, sold status, expiration). Don't loop `get_product` over many search\n    results — re-search with tighter filters instead.\n\n    Read-only. No authentication.\n\n    Args:\n      ","read_only":true},{"name":"search_stores","title":"Search stores","description":"Search or list stores in the Partle marketplace.\n\n    Use for store-led questions (\"what hardware shops are in Madrid?\") rather\n    than product-led ones (use `search_products` for that). Pass no query to\n    browse the whole catalog.\n\n    Read-only. No authentication. Rate-limited to 100 requests/hour per IP.\n\n    Args:\n        query: Free-text search over store name and address. Omit to list\n   ","read_only":true},{"name":"get_store","title":"Get store details","description":"Get the full record for a single store by its numeric ID.\n\n    Use after `search_stores` to retrieve fields not in the search summary\n    (full address, owner profile, contact details). For a list of *products*\n    in that store, call `search_products(store_id=…)` instead — this tool\n    returns store metadata only.\n\n    Read-only. No authentication.\n\n    Args:\n        store_id: Integer `id` from ","read_only":true},{"name":"get_stats","title":"Get platform stats","description":"Get top-level Partle platform statistics.\n\n    Use for size questions (\"how big is Partle?\", \"how many stores does\n    Partle cover?\"). Aggregate counts only — no per-product or per-store\n    data; use `search_products` / `search_stores` for that.\n\n    Read-only. No authentication. Cheap, but rarely changes — long-running\n    agents should cache the result.\n\n    Returns:\n        ``{\"total_products","read_only":true},{"name":"search_wanted","title":"Search buy requests (public demand feed)","description":"Browse public buy requests — what users are looking to buy but\n    haven't found through normal supply.\n\n    The demand side of Partle. Use this when an agent wants to **offer\n    matches** (cross-reference open requests against `search_products`\n    and surface hits) or just survey unmet demand. Every result is a\n    public posting — users put these up specifically so suppliers can\n    reach them","read_only":true},{"name":"create_buy_request","title":"Create buy request","description":"Post a public buy request — an ad asking suppliers to reach out.\n\n    Use when the user wants others to know they're looking to buy\n    something. **Independent of personal inventory** — inventory is the\n    user's private workshop tracking; a buy request is a sales-facing\n    ad on the public demand feed at /wanted.\n\n    Authenticated. Required OAuth scope: ``inventory:write``.\n    **Not idempote","read_only":false},{"name":"submit_feedback","title":"Submit feedback","description":"Report a problem with **the Partle marketplace API/MCP itself**.\n\n    Authenticated. Prefer **OAuth**: connect once via the consent flow and the\n    bearer token is attached automatically. **Fallback**: pass an `api_key`\n    (prefix `pk_`, generate at /account). Required OAuth scope: `feedback:write`.\n    Feedback is attributed to your account so reports are trustworthy and the\n    channel can't b","read_only":false},{"name":"create_product","title":"Create product","description":"Create a new product listing on Partle.\n\n    Authenticated. Prefer **OAuth**: connect once via the consent flow on\n    claude.ai (or any MCP client that supports OAuth) and the bearer token\n    is attached automatically — no `api_key` parameter needed. **Fallback**:\n    pass an `api_key` (prefix `pk_`, generate at /account) for programmatic\n    or non-OAuth clients.\n\n    Required OAuth scope: `pro","read_only":false},{"name":"update_product","title":"Update product","description":"Update an existing product listing. Only provided fields are changed.\n\n    Authenticated. OAuth (scope `products:write`) preferred; `api_key` accepted\n    as fallback.\n\n    Only fields you pass are changed; omitted fields are preserved.\n    Idempotent — calling twice with the same input yields the same final\n    state. For creating a new listing, use `create_product` instead.\n\n    Caller must own ","read_only":false},{"name":"delete_product","title":"Delete product","description":"Permanently delete a product listing and all its images. Destructive.\n\n    Authenticated. OAuth (scope `products:write`) preferred; `api_key` fallback.\n\n    Use only when the user explicitly asks to remove a listing they own.\n    Cannot be undone — there is no soft-delete or trash bin. Idempotent:\n    deleting a product that no longer exists returns an error, not duplicate\n    side effects.\n\n    C","read_only":false},{"name":"delete_product_image","title":"Delete product image","description":"Remove a specific image from a product. Destructive, idempotent.\n\n    Authenticated. OAuth (scope `products:write`) preferred; `api_key` fallback.\n\n    Use when an image was uploaded by mistake or the merchant updated their\n    listing. The product itself is preserved — only the image record and its\n    file are removed. To remove the product entirely use `delete_product`.\n\n    Args:\n        produ","read_only":false},{"name":"get_my_products","title":"List my products","description":"List products created by the authenticated user.\n\n    Authenticated. OAuth (scope `products:read`) preferred; `api_key` fallback.\n\n    Use when the user asks \"what have I listed?\" or before bulk operations\n    like updating prices across multiple of their products. Distinct from\n    `search_products`, which searches the public catalog without owner\n    scoping.\n\n    Read-only.\n\n    Args:\n        l","read_only":true},{"name":"get_upload_url","title":"Get image upload URL","description":"Mint a one-shot signed upload URL for a product you own.\n\n    Authenticated. OAuth (scope `products:write`) preferred; `api_key` fallback.\n\n    Use this when you have **local image bytes** (a file the user attached,\n    bytes you generated/downloaded in your sandbox) and you want to attach\n    them to a product that already exists. Common cases:\n\n    - `create_product` returned 409 (duplicate name","read_only":false},{"name":"upload_product_image","title":"Upload product image","description":"Attach an image to an existing product by giving Partle a public URL\n    to download the image from.\n\n    Authenticated. OAuth (scope `products:write`) preferred; `api_key` fallback.\n\n    **When to use this tool**: the image is already hosted at a public URL\n    (a scraped product page, an Imgur link, a CDN URL the user provided).\n    Partle's server fetches it and stores it.\n\n    **When NOT to us","read_only":false},{"name":"get_my_inventory","title":"Get my inventory","description":"List the caller's personal inventory items.\n\n    Authenticated. Required OAuth scope: `inventory:read` (or pass an\n    `api_key` for legacy/programmatic clients).\n\n    Use this when the user asks \"what do I own?\", \"what's on my\n    wishlist?\", \"what am I selling?\", etc. The returned rows include\n    every status by default; pass `status` to filter.\n\n    Args:\n        status: Filter by lifecycle. O","read_only":true},{"name":"add_inventory_item","title":"Add inventory item","description":"Add an item to the caller's personal inventory.\n\n    Authenticated. Required OAuth scope: `inventory:write`.\n\n    One creation tool covers all lifecycle states — set ``status`` based\n    on the user's intent: \"I bought\" → ``owned``, \"I want\" → ``wanted``,\n    \"I'm selling\" → ``for_sale``. Either ``product_id`` (linked to an\n    existing Partle product) or ``name`` (freeform) must be set.\n\n    **No","read_only":false},{"name":"update_inventory_item","title":"Update inventory item","description":"Patch an existing inventory item. Only provided fields change.\n\n    Authenticated. Required OAuth scope: `inventory:write`. Caller must\n    own the item (404 otherwise — we don't leak existence).\n\n    Idempotent: calling twice with the same input yields the same final\n    state. For lifecycle convenience, see `mark_for_sale` and\n    `mark_sold` which set the right combination of fields atomically.","read_only":false},{"name":"delete_inventory_item","title":"Delete inventory item","description":"Permanently delete an inventory row.\n\n    Authenticated. Required OAuth scope: `inventory:write`. Caller must\n    own the item (404 otherwise). Hard delete — no soft-delete.\n\n    Args:\n        item_id: ID of the row to delete.\n        api_key: Optional API key (`pk_*`, generate at /account).\n            Used when there is no OAuth token, and also when the OAuth\n            token lacks the required","read_only":false},{"name":"mark_for_sale","title":"Mark inventory item for sale","description":"Move an inventory item to status=for_sale and set listing fields.\n\n    Convenience wrapper over `update_inventory_item` that matches a\n    natural user request (\"list my drill for sale at 30€\"). Sets all\n    three columns (`status`, `asking_price`, `asking_currency`, and\n    optionally `condition`) atomically.\n\n    Authenticated. Required OAuth scope: `inventory:write`. Caller must\n    own the ite","read_only":false},{"name":"mark_sold","title":"Mark inventory item sold","description":"Mark an inventory item as sold (status=sold).\n\n    Convenience wrapper over `update_inventory_item` for the natural\n    \"I sold the drill\" request.\n\n    Authenticated. Required OAuth scope: `inventory:write`. Caller must\n    own the item.\n\n    Args:\n        item_id: ID of the inventory row.\n        api_key: Optional API key (`pk_*`, generate at /account).\n            Used when there is no OAuth to","read_only":false},{"name":"get_account_settings","title":"Read account settings","description":"Read your account ID, email, username and theme. Requires OAuth account:read.\n\n    Passwords and key secrets are never returned. No other account can be selected.\n    A null theme means no account preference has been set; the browser keeps its local choice.\n    ","read_only":true},{"name":"update_account_settings","title":"Change account theme","description":"Set your account theme to light, dark, or system. Requires OAuth account:write.\n\n    The website applies it on login, reload or return to its tab. This only\n    changes the theme; passwords, roles and sign-in providers cannot be changed.\n    ","read_only":false},{"name":"set_account_username","title":"Set account username","description":"Set your username once, only if unset. Requires OAuth account:write.\n\n    Use 3–20 letters, digits, underscores or dashes. Existing usernames cannot\n    be changed. Ask the user which public username they want before setting it.\n    ","read_only":false},{"name":"list_account_api_keys","title":"List account API keys","description":"List your key IDs, labels, prefixes and dates, never secrets. Requires OAuth security:read.","read_only":true},{"name":"create_account_api_key","title":"Create account API key","description":"Create a full-access catalog/inventory API key. Requires OAuth security:write.\n\n    The secret is returned ONCE. Store it securely; never include it in a public\n    message or logs. This grants broader catalog/inventory access than a limited\n    OAuth token. It cannot manage account settings or credentials through MCP.\n    Each call creates a new key; do not retry blindly after a lost response.\n  ","read_only":false},{"name":"rotate_account_api_key","title":"Prepare account API key rotation","description":"Create a replacement for your key, keeping the old key ACTIVE. Requires OAuth security:write.\n\n    Returns the replacement secret ONCE with its new ID. Install it in the\n    consumer, test it, then call revoke_account_api_key with previous_key_id.\n    Do not revoke until the replacement is working. Each call creates a key;\n    do not retry blindly after a lost response. Never publish the secret.\n ","read_only":false},{"name":"revoke_account_api_key","title":"Revoke account API key","description":"Immediately revoke one of your API keys. Requires OAuth security:write.\n\n    Consumers using the key will lose access. For rotation, first install and\n    test the replacement returned by rotate_account_api_key.\n    ","read_only":false},{"name":"list_connected_apps","title":"List connected apps","description":"List apps with active access to your account and their permissions. Requires OAuth security:read.","read_only":true},{"name":"revoke_connected_app","title":"Disconnect account app","description":"Revoke an app's access AND refresh tokens for your account. Requires OAuth security:write.\n\n    This disconnects the app immediately. Revoking your own calling app also\n    works, but subsequent requests will fail until you reconnect with consent.\n    ","read_only":false}],"server_info":{"name":"Partle Marketplace","version":"1.30.0"},"category":"ecommerce","tags":["web-search","agents","image-video"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-05-10","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/xyz-rubenayla-partle-marketplace/"}