Partle

5 toolsHTTPregistry active

Summary

Connects Claude to Partle's local marketplace of 130,000+ products across 16,000 physical stores. You get 20 tools: search and read the catalog without auth, then create or update listings with OAuth or an API key. The write side includes inventory tracking (owned, wanted, for sale, sold) and public buy requests that appear on the /wanted feed. Supports semantic search across languages, image uploads, and price filtering. Run it remotely via streamable HTTP at partle.rubenayla.xyz/mcp/ or install locally with uvx partle-mcp. Useful when you want an agent to find products near you or post items for sale without leaving the chat.

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

MCP-ready Email Sending

Plug Mailtrap into your AI workflow and let it handle the email.

Connect Mailtrap MCP →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Capacitor - Shared memory for your team’s coding agents.

Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.

Try For Free →

CodeScene MCP Server

Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.

Try For Free →

Give your AI the whole web as clean markdown

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

inference shell

create and run specialised agents in minutes

build now →

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

MCP-ready Email Sending

Plug Mailtrap into your AI workflow and let it handle the email.

Connect Mailtrap MCP →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Capacitor - Shared memory for your team’s coding agents.

Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.

Try For Free →

CodeScene MCP Server

Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.

Try For Free →

Give your AI the whole web as clean markdown

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

inference shell

create and run specialised agents in minutes

build now →

Tools

Public tool metadata for what this MCP can expose to an agent.

5 tools

search_productsSearch marketplace products by name or description. Args: query: Search term (e.g. "wireless headphones", "cerrojo"). min_price: Minimum price filter in EUR. max_price: Maximum price filter in EUR. tags: Comma-separated tag filter (e.g. "electronics,bluetooth"). sort_by: Sort...6 params

Search marketplace products by name or description. Args: query: Search term (e.g. "wireless headphones", "cerrojo"). min_price: Minimum price filter in EUR. max_price: Maximum price filter in EUR. tags: Comma-separated tag filter (e.g. "electronics,bluetooth"). sort_by: Sort...

Parameters* required

limitinteger

default: 20

max_pricevalue

min_pricevalue

querystring

sort_byvalue

tagsvalue

get_productGet detailed information about a single product by its ID. Args: product_id: The product ID.1 params

Get detailed information about a single product by its ID. Args: product_id: The product ID.

Parameters* required

product_idinteger

search_storesSearch or list stores in the marketplace. Args: query: Optional search term to filter stores by name or address. limit: Max results (1-50, default 20).2 params

Search or list stores in the marketplace. Args: query: Optional search term to filter stores by name or address. limit: Max results (1-50, default 20).

Parameters* required

limitinteger

default: 20

queryvalue

get_storeGet detailed information about a single store by its ID. Args: store_id: The store ID.1 params

Get detailed information about a single store by its ID. Args: store_id: The store ID.

Parameters* required

store_idinteger

get_statsGet platform statistics (total products, total stores).

Get platform statistics (total products, total stores).

No parameter schema in public metadata yet.

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:

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

Featured

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

MCP-ready Email Sending

Plug Mailtrap into your AI workflow and let it handle the email.

Connect Mailtrap MCP →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Capacitor - Shared memory for your team’s coding agents.

Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.

Try For Free →

CodeScene MCP Server

Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.

Try For Free →

Give your AI the whole web as clean markdown

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

inference shell

create and run specialised agents in minutes

build now →

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:

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

Partle

Tools

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

Partle

Tools

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

More from rubenayla

Related Search & Web Crawling MCP Servers

More from rubenayla

Related Search & Web Crawling MCP Servers