Agents Index

Partle

Online

Search products in nearby stores. Agents can also list items for sale on a user's behalf.

Visit publisherConnectJSON

What it can do: 30 tools

  • search_products read-onlySearch Partle's product catalog by name or description. CRITICAL SEARCH INSTRUCTION: Reason from the job to the product class first, then search with a descriptive product phrase (e.g. including substrate, mate
  • get_product read-onlyGet the full record for a single product by its numeric ID. Use after `search_products` returns a candidate the user is interested in, when you need fields not in the search summary (full description, all im
  • search_stores read-onlySearch or list stores in the Partle marketplace. Use for store-led questions ("what hardware shops are in Madrid?") rather than product-led ones (use `search_products` for that). Pass no query to browse the
  • get_store read-onlyGet the full record for a single store by its numeric ID. Use after `search_stores` to retrieve fields not in the search summary (full address, owner profile, contact details). For a list of *products* in th
  • get_stats read-onlyGet top-level Partle platform statistics. Use for size questions ("how big is Partle?", "how many stores does Partle cover?"). Aggregate counts only — no per-product or per-store data; use `search_products`
  • search_wanted read-onlyBrowse public buy requests — what users are looking to buy but haven't found through normal supply. The demand side of Partle. Use this when an agent wants to **offer matches** (cross-reference open requests
  • create_buy_requestPost a public buy request — an ad asking suppliers to reach out. Use when the user wants others to know they're looking to buy something. **Independent of personal inventory** — inventory is the user's priva
  • submit_feedbackReport a problem with **the Partle marketplace API/MCP itself**. Authenticated. Prefer **OAuth**: connect once via the consent flow and the bearer token is attached automatically. **Fallback**: pass an `api_key`
  • create_productCreate a new product listing on Partle. Authenticated. Prefer **OAuth**: connect once via the consent flow on claude.ai (or any MCP client that supports OAuth) and the bearer token is attached automatically
  • update_productUpdate an existing product listing. Only provided fields are changed. Authenticated. OAuth (scope `products:write`) preferred; `api_key` accepted as fallback. Only fields you pass are changed; omitted field
  • delete_productPermanently delete a product listing and all its images. Destructive. Authenticated. OAuth (scope `products:write`) preferred; `api_key` fallback. Use only when the user explicitly asks to remove a listing they
  • delete_product_imageRemove a specific image from a product. Destructive, idempotent. Authenticated. OAuth (scope `products:write`) preferred; `api_key` fallback. Use when an image was uploaded by mistake or the merchant updated th
  • get_my_products read-onlyList products created by the authenticated user. Authenticated. OAuth (scope `products:read`) preferred; `api_key` fallback. Use when the user asks "what have I listed?" or before bulk operations like updat
  • get_upload_urlMint a one-shot signed upload URL for a product you own. Authenticated. OAuth (scope `products:write`) preferred; `api_key` fallback. Use this when you have **local image bytes** (a file the user attached,
  • upload_product_imageAttach an image to an existing product by giving Partle a public URL to download the image from. Authenticated. OAuth (scope `products:write`) preferred; `api_key` fallback. **When to use this tool**: the i
  • get_my_inventory read-onlyList the caller's personal inventory items. Authenticated. Required OAuth scope: `inventory:read` (or pass an `api_key` for legacy/programmatic clients). Use this when the user asks "what do I own?", "what'
  • add_inventory_itemAdd an item to the caller's personal inventory. Authenticated. Required OAuth scope: `inventory:write`. One creation tool covers all lifecycle states — set ``status`` based on the user's intent: "I bought"
  • update_inventory_itemPatch an existing inventory item. Only provided fields change. Authenticated. Required OAuth scope: `inventory:write`. Caller must own the item (404 otherwise — we don't leak existence). Idempotent: calling
  • delete_inventory_itemPermanently delete an inventory row. Authenticated. Required OAuth scope: `inventory:write`. Caller must own the item (404 otherwise). Hard delete — no soft-delete. Args: item_id: ID of the row to d
  • mark_for_saleMove an inventory item to status=for_sale and set listing fields. Convenience wrapper over `update_inventory_item` that matches a natural user request ("list my drill for sale at 30€"). Sets all three column
  • mark_soldMark an inventory item as sold (status=sold). Convenience wrapper over `update_inventory_item` for the natural "I sold the drill" request. Authenticated. Required OAuth scope: `inventory:write`. Caller must
  • get_account_settings read-onlyRead your account ID, email, username and theme. Requires OAuth account:read. Passwords and key secrets are never returned. No other account can be selected. A null theme means no account preference has been set
  • update_account_settingsSet your account theme to light, dark, or system. Requires OAuth account:write. The website applies it on login, reload or return to its tab. This only changes the theme; passwords, roles and sign-in providers c
  • set_account_usernameSet your username once, only if unset. Requires OAuth account:write. Use 3–20 letters, digits, underscores or dashes. Existing usernames cannot be changed. Ask the user which public username they want before set
  • list_account_api_keys read-onlyList your key IDs, labels, prefixes and dates, never secrets. Requires OAuth security:read.
  • create_account_api_keyCreate a full-access catalog/inventory API key. Requires OAuth security:write. The secret is returned ONCE. Store it securely; never include it in a public message or logs. This grants broader catalog/inventory
  • rotate_account_api_keyCreate a replacement for your key, keeping the old key ACTIVE. Requires OAuth security:write. Returns the replacement secret ONCE with its new ID. Install it in the consumer, test it, then call revoke_account_ap
  • revoke_account_api_keyImmediately revoke one of your API keys. Requires OAuth security:write. Consumers using the key will lose access. For rotation, first install and test the replacement returned by rotate_account_api_key.
  • list_connected_apps read-onlyList apps with active access to your account and their permissions. Requires OAuth security:read.
  • revoke_connected_appRevoke an app's access AND refresh tokens for your account. Requires OAuth security:write. This disconnects the app immediately. Revoking your own calling app also works, but subsequent requests will fail until

Connect it

Claude Code
claude mcp add --transport http partle https://partle.rubenayla.xyz/mcp/
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://partle.rubenayla.xyz/mcp/
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "partle": {
      "url": "https://partle.rubenayla.xyz/mcp/"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "partle": {
      "type": "http",
      "url": "https://partle.rubenayla.xyz/mcp/"
    }
  }
}

Questions

What does Partle do?

Search products in nearby stores. Agents can also list items for sale on a user's behalf. It exposes 30 tools to AI assistants.

What tools does Partle provide?

30 tools, including search_products, get_product, search_stores, get_store, get_stats, search_wanted, create_buy_request, submit_feedback, create_product, update_product, delete_product, delete_product_image….

How do I connect Partle to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://partle.rubenayla.xyz/mcp/ as a custom connector or MCP server. Copy-paste setup is on this page.

Does Partle require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is Partle online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes Partle?

partle.rubenayla.xyz. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in E-commerce & Shopping