xyz.rubenayla.partle/marketplace — MCP Server

The Model Context Protocol server for Partle local marketplace enables searching products in nearby stores and supports agents listing items for sale on a user’s behalf, with read access openly available and write operations gated by an API key.

🛠️ Key Features

MCP-compliant server for local marketplace queries
Discover 130,000+ products across ~16,000 stores
Read access without authentication; writes require a pk_ API key
Remote, zero-setup deployment recommended
Streamable HTTP transport and MCP spec 2025-06-18

🚀 Use Cases

Search for products in nearby physical stores
Have an AI agent list items for sale on a user’s behalf
Integrate Partle marketplace data into assistants without leaving the chat

⚡ Developer Benefits

Clear remote endpoint: https://partle.rubenayla.xyz/mcp/
No auth required for reads, simplifies prototyping
Up-to-date MCP 2025-06-18 compatibility

⚠️ Limitations

Writes require a pk_ API key; authentication is enforced for modifications
Read data exposure described but not deeply detailed in excerpt
Limited by the underlying data scope: 130k+ products across 16k stores

Partle Marketplace MCP Server

Verified on MseeP

Model Context Protocol server for the Partle marketplace — let your AI shop here: search products and stores, get prices and purchase links, or ask it to add a listing for you, all without leaving your assistant.

Live product and store coverage is available through the get_stats tool. Public catalogue reads need no auth. Writes and private inventory reads need OAuth or a pk_… API key.

Two ways to run it

Remote (recommended — zero setup)

Point your MCP client at:

code

https://partle.rubenayla.xyz/mcp/

That's it. Streamable HTTP transport, MCP spec 2025-06-18. Per-client install instructions: /documentation/mcp-setup/.

Local stdio (for clients that prefer installable servers, or for Glama / Smithery scoring)

bash

pip install partle-mcp
partle-mcp

Or with uvx (no install):

bash

uvx partle-mcp

Or with Docker:

bash

docker run --rm -i ghcr.io/rubenayla/partle-mcp

The stdio package proxies to the public REST API at https://partle.rubenayla.xyz, so you don't need a database or local backend.

Claude Desktop / Claude Code (stdio)

json

{
  "mcpServers": {
    "partle": {
      "command": "uvx",
      "args": ["partle-mcp"]
    }
  }
}

Tools (20 total)

Read (no auth)

Tool	Purpose
`search_products`	Search the catalog by name, price range, tags, store. Supports cross-language semantic search.
`get_product`	Full record for one product by ID.
`search_stores`	Search/list stores by name or address.
`get_store`	Full record for one store by ID.
`get_stats`	Platform-wide totals.
`search_wanted`	Browse public buy requests at `/wanted` — things people are looking to buy but haven't found. Cross-reference against `search_products` to offer matches.

Write (authenticated)

Two ways to authenticate, in preference order:

OAuth (recommended) — when you add Partle as a custom connector in claude.ai or any MCP client that supports OAuth, the client walks you through a one-click consent screen and attaches a bearer token automatically. Scopes: products:read, products:write, inventory:read, inventory:write. Revoke at /account → Connected apps. RFC 9728 metadata at /.well-known/oauth-protected-resource; RFC 7591 dynamic client registration at /oauth/register.
API key (fallback) — pass an api_key parameter to any write tool. Generate at /account → API Keys. Use this when your client doesn't support OAuth (raw scripts, programmatic agents).

Products — public catalog listings.

Tool	Purpose
`create_product`	Add a new listing. Set `verified=false` when an AI is proposing on behalf of an unconfirmed human.
`update_product`	Edit a listing you own.
`delete_product`	Remove a listing you own.
`upload_product_image`	Attach an image (base64 or URL).
`delete_product_image`	Remove an image from a product.
`get_my_products`	List products you've created.

The remote HTTP server also offers get_upload_url (re-fetches a signed upload URL for an existing product). Not exposed in this stdio package — use the remote server if you need it.

Inventory — private workshop tracking (owned / wanted / for_sale / sold / discarded). Private to the owner; does not appear on the public /wanted feed.

Tool	Purpose
`get_my_inventory`	List your inventory items. Filterable by status, project, free text.
`add_inventory_item`	Add a row in any lifecycle state.
`update_inventory_item`	Patch any field.
`delete_inventory_item`	Permanently remove a row.
`mark_for_sale`	Convenience: flip an `owned` item to `for_sale` and set an asking price.
`mark_sold`	Convenience: flip a `for_sale` item to `sold`.

Buy requests — public demand-side posts on /wanted. Independent of personal inventory.

Tool	Purpose
`create_buy_request`	Post a public buy request (name, description, quantity, optional `max_price` and `contact`).

Feedback

Tool	Purpose
`submit_feedback`	Send freeform feedback about your integration experience.

Public REST API

Same data, also reachable as plain HTTP for clients without MCP support:

GET /v1/public/products?q=cerrojo&limit=10 — search products
GET /v1/public/stores?q=Madrid&limit=10 — search stores
GET /v1/public/wanted?q=bolt&limit=10 — list open public buy requests
GET /v1/public/stats — platform totals
POST /v1/public/feedback — submit feedback

Base URL: https://partle.rubenayla.xyz. Rate-limited to 100 req/hour per IP.

Full docs: /documentation/ · OpenAPI: /openapi.json · Discovery: /.well-known/mcp.json.

Example

You: "Use Partle to find a drill under €50."

Claude: (calls search_products(query="drill", max_price=50))

Returns Blackspur 13pc High Speed Drill Bit Set at €4.99 (Lenehans, IE), Flotec Drill Pump 225 GPH at €17.14 (Kooyman Megastore, NL), and a few more — each with a partle_url to view the listing.

More examples in the setup guide.

License

Apache-2.0 — see LICENSE.

query	string	required
min_price	any	optional
max_price	any	optional
tags	any	optional
store_id	any	optional
sort_by	any	optional
has_price	any	optional
semantic	boolean	optional
super_search	boolean	optional
limit	integer	optional
offset	integer	optional

title	string	required
description	any	optional
quantity	integer	optional
max_price	any	optional
currency	any	optional
contact	any	optional
reference_url	any	optional
product_id	any	optional
api_key	any	optional

name	string	required
description	any	optional
price	any	optional
currency	any	optional
url	any	optional
store_id	any	optional
idempotency_key	any	optional
api_key	any	optional

status	any	optional
product_id	any	optional
project	any	optional
q	any	optional
limit	integer	optional
offset	integer	optional
api_key	any	optional

item_id	integer	required
name	any	optional
product_id	any	optional
status	any	optional
quantity	any	optional
notes	any	optional
acquisition_price	any	optional
acquisition_currency	any	optional
purchased_at	any	optional
asking_price	any	optional
asking_currency	any	optional
condition	any	optional
external_link	any	optional
external_id	any	optional
project	any	optional
api_key	any	optional

xyz.rubenayla.partle/marketplace — MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

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

get_my_products

get_upload_url

upload_product_image

get_my_inventory

add_inventory_item

update_inventory_item

delete_inventory_item

mark_for_sale

mark_sold

Partle Marketplace MCP Server

Two ways to run it

Remote (recommended — zero setup)

Local stdio (for clients that prefer installable servers, or for Glama / Smithery scoring)

Claude Desktop / Claude Code (stdio)

Tools (20 total)

Read (no auth)

Write (authenticated)

Feedback

Public REST API

Example

License

Install

Remote endpoint

Related servers