How do I install Partle?

Partle supports both local and remote installation. For local use, install it via the provided package manager and add the configuration to your AI app. For remote access, add the server URL to your MCP configuration.

What AI apps work with Partle?

Partle uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Partle MCP Server

by Rubenayla

Developer ToolsModerate5.2MCP RegistryLocalRemote

Free

Server data from the Official MCP Registry

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

About

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/

Security Report

5.2

Moderate5.2Moderate Risk

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.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

Partle Marketplace MCP Server

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.

Two ways to run it

Remote (recommended — zero setup)

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/.

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

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.

Claude Desktop / Claude Code (stdio)

{
  "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 (title, 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.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Partle MCP Server

About

Security Report

Findings (7)Action required

Permissions Required

How to Install & Connect

Documentation

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

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

FinAgent