You can search products by name, price range, tags, or store, and search stores by name or address.

Can it manage personal inventory?

Yes. Authenticated users can add, update, delete, and list private inventory items, and mark items for sale or sold.

How can I run the server?

Use the hosted endpoint at https://partle.rubenayla.xyz/mcp/ or run the local stdio package with pip, uvx, or Docker.

Partle MCP

marketplaceproduct-searchlocal-shoppinginventory

Search nearby products and stores, compare prices, and manage listings or inventory through Partle.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Partle MCP connects assistants to the Partle marketplace, with product and store search, prices, purchase links, and platform statistics. Read operations require no authentication, while listing, inventory, and buy-request changes require OAuth or an API key. Use the hosted Streamable HTTP endpoint for zero-setup access, or run the package locally via stdio.

Use cases

Find products at nearby physical stores

Compare listings by price, tags, or store

Create and update marketplace product listings

Track personal inventory across lifecycle states

Browse or publish public buy requests

Key features

Semantic product search with price, tag, and store filters

Store search by name or address

Product and store detail retrieval

Authenticated product and inventory management

Public buy-request browsing and creation

Hosted Streamable HTTP and local stdio transport

Capabilities & Tool Schemas (20)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Partle MCP.

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.

Documentation Overview

Partle Marketplace MCP Server

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)

Terminal

pip install partle-mcp
partle-mcp

Or with uvx (no install):

bash

uvx partle-mcp

Or with Docker:

Terminal

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)

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Search & Data Extraction View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

11d ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Partle MCP

Read operations require no authentication. Write operations use OAuth when supported or a Partle API key as a fallback.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/rubenayla-partle-mcp?style=directory)](https://allmcps.com/mcp/rubenayla-partle-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/rubenayla-partle-mcp"><img src="https://allmcps.com/api/badge/rubenayla-partle-mcp?style=directory" alt="Partle MCP on AllMCPs" /></a>

Technical Specs & Signals

CategorySearch & Data Extraction

PricingFree

3/7 checks healthy over the last 32d

56Quality signal: Good · 56/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools28/30

Adoption & activity4/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 26d ago via OSV.dev · partle-mcp (PyPI)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🔎 Search & Data Extraction →Best MCP servers for Web Search & Scraping →Alternatives to Partle MCP →Install in Claude Desktop Install in Cursor Install in VS Code

Partle MCP

marketplaceproduct-searchlocal-shoppinginventory

Search nearby products and stores, compare prices, and manage listings or inventory through Partle.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Use cases

Find products at nearby physical stores

Compare listings by price, tags, or store

Create and update marketplace product listings

Track personal inventory across lifecycle states

Browse or publish public buy requests

Key features

Semantic product search with price, tag, and store filters

Store search by name or address

Product and store detail retrieval

Authenticated product and inventory management

Public buy-request browsing and creation

Hosted Streamable HTTP and local stdio transport

Capabilities & Tool Schemas (20)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Partle MCP.

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.

Documentation Overview

Partle Marketplace MCP Server

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)

Terminal

pip install partle-mcp
partle-mcp

Or with uvx (no install):

bash

uvx partle-mcp

Or with Docker:

Terminal

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)

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Search & Data Extraction View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

11d ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Partle MCP

Read operations require no authentication. Write operations use OAuth when supported or a Partle API key as a fallback.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/rubenayla-partle-mcp?style=directory)](https://allmcps.com/mcp/rubenayla-partle-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/rubenayla-partle-mcp"><img src="https://allmcps.com/api/badge/rubenayla-partle-mcp?style=directory" alt="Partle MCP on AllMCPs" /></a>

Technical Specs & Signals

CategorySearch & Data Extraction

PricingFree

3/7 checks healthy over the last 32d

56Quality signal: Good · 56/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools28/30

Adoption & activity4/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 26d ago via OSV.dev · partle-mcp (PyPI)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🔎 Search & Data Extraction →Best MCP servers for Web Search & Scraping →Alternatives to Partle MCP →Install in Claude Desktop Install in Cursor Install in VS Code