Server data from the Official MCP Registry
Search products in nearby stores. Agents can also list items for sale on a user's behalf.
Search products in nearby stores. Agents can also list items for sale on a user's behalf.
Remote endpoints: streamable-http: https://partle.rubenayla.xyz/mcp/
This is a well-structured MCP server that proxies to the Partle marketplace API. Authentication is properly implemented via API keys and OAuth, with clear separation between unauthenticated read operations and authenticated write operations. Code quality is solid with good input validation through tool definitions, appropriate error handling, and no evidence of malicious patterns. Minor code quality observations around broad exception handling and logging do not materially affect the security posture. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity).
5 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Available as Local & Remote
This plugin can run on your machine or connect to a hosted endpoint. during install.
From the project's GitHub README.
Model Context Protocol server for the Partle local marketplace — find products in physical stores near you, ask an AI to add a listing for you, all without leaving your assistant.
130,000+ products across ~16,000 stores. Reads need no auth. Writes need a pk_… API key.
Point your MCP client at:
https://partle.rubenayla.xyz/mcp/
That's it. Streamable HTTP transport, MCP spec 2025-06-18. Per-client install instructions: /documentation/mcp-setup/.
pip install partle-mcp
partle-mcp
Or with uvx (no install):
uvx partle-mcp
Or with Docker:
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.
{
"mcpServers": {
"partle": {
"command": "uvx",
"args": ["partle-mcp"]
}
}
}
| 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. |
Two ways to authenticate, in preference order:
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 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 (title, description, quantity, optional max_price and contact). |
| Tool | Purpose |
|---|---|
submit_feedback | Send freeform feedback about your integration experience. |
Same data, also reachable as plain HTTP for clients without MCP support:
GET /v1/public/products?q=cerrojo&limit=10 — search productsGET /v1/public/stores?q=Madrid&limit=10 — search storesGET /v1/public/wanted?q=bolt&limit=10 — list open public buy requestsGET /v1/public/stats — platform totalsPOST /v1/public/feedback — submit feedbackBase URL: https://partle.rubenayla.xyz. Rate-limited to 100 req/hour per IP.
Full docs: /documentation/ · OpenAPI: /openapi.json · Discovery: /.well-known/mcp.json.
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_urlto view the listing.
More examples in the setup guide.
Apache-2.0 — see LICENSE.
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.