How do I install Arugula?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Arugula need an API key?

No required environment variable is listed on this record.

When was Arugula last checked?

Last checked 2026-11-08. Find offers that fit what you want, ranked by fit only, with links to buy.

Arugula MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.arugulanet.com/mcp?ch=mcp-registry

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.arugulanet-arugula https://mcp.arugulanet.com/mcp?ch=mcp-registry

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.arugulanet-arugula": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.arugulanet.com/mcp?ch=mcp-registry"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Arugula

Offers that fit, wherever people ask.

Arugula is a matching engine. Someone says what they want, in their own words, in their assistant, on a website or in a chat. Arugula matches the request on meaning against merchants' offers and returns the ones that fit, best first. Each offer comes with its price, a one-line reason why it fits, and a link to buy from the merchant.

Ranked by fit only. Nobody can pay to be placed higher.
Commission, disclosed. Arugula may earn a commission if you buy through these links, at no extra cost to you. Every list of offers says so.
No account needed. Every surface below works without signing up.
When nothing fits, nothing is shown.

Website: arugulanet.com · Privacy: arugulanet.com/privacy · Terms: arugulanet.com/terms

By using Arugula you agree to arugulanet.com/terms. Privacy: arugulanet.com/privacy.

Where to use it

Surface	For	Status
MCP server	Claude, Cursor, Open WebUI, LibreChat, Jan, LM Studio and any MCP client	Live
Telegram	Chats and groups	Live
Site search	Any website with a search box	Live
Shopify	Shopify stores	Live
Google Tag Manager	Sites that use GTM	Live (import); gallery listing in review
WordPress	WordPress sites	Live (ZIP); WordPress.org listing in review
Cloudflare Zaraz	Sites that use Zaraz	Live
Cloudflare Worker	Sites on Cloudflare without Zaraz	Live
Chatbots	Chatwoot, Botpress, Rasa, Voiceflow and your own bot	Live, partner key on request
Python	Your own agents (LangChain, LangGraph, CrewAI)	Live on PyPI
JavaScript	Your own agents	Coming soon
Chrome and Firefox extensions	Your browser	Coming soon
Claude directory, ChatGPT app	Assistants	Coming soon
Discord	Servers	Coming soon

MCP server

https://mcp.arugulanet.com/mcp: Streamable HTTP. No key and no sign-in.

Tool	What it does
`find_offers`	Takes a request in plain words and returns the offers that fit, best first.
`get_offers`	Gets the offers found for a request from `find_offers`; matching can take a few seconds.
`explain_match`	Says why an offer fits a request.

Each client below has its own address, ending in ?ch=. That tag only tells us which kind of client sent a request, so we can see which ones people use.

Claude (web and desktop): Settings, then Connectors, then Add custom connector, with https://mcp.arugulanet.com/mcp?ch=claude-connector. Custom connectors are available on some Claude plans only.

Claude Code:

claude mcp add --transport http arugula "https://mcp.arugulanet.com/mcp?ch=claude-connector"

Cursor: add this to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project). This repository is also a Cursor plugin (.cursor-plugin/plugin.json and mcp.json).

{
  "mcpServers": {
    "arugula": {
      "url": "https://mcp.arugulanet.com/mcp?ch=cursor"
    }
  }
}

One-click install, if your system opens cursor:// links:

cursor://anysphere.cursor-deeplink/mcp/install?name=arugula&config=eyJ1cmwiOiJodHRwczovL21jcC5hcnVndWxhbmV0LmNvbS9tY3A/Y2g9Y3Vyc29yIn0=

Open WebUI (0.6.31 or later): Admin Settings, then External Tools, then + Add Server. Type MCP (Streamable HTTP), URL https://mcp.arugulanet.com/mcp?ch=open-webui, Auth None. The URL must be reachable from the Open WebUI server.

LibreChat: in librechat.yaml:

mcpServers:
  arugula:
    type: streamable-http
    url: https://mcp.arugulanet.com/mcp?ch=librechat
    title: Arugula
    description: Find offers that fit what you want, ranked by fit only.
    timeout: 60000

Jan: Settings, then MCP Servers, then + Add MCP Server. Name arugula, transport HTTP, URL https://mcp.arugulanet.com/mcp?ch=jan. Turn tools on for the model you use.

LM Studio (0.3.17 or later): Program tab, then Install, then Edit mcp.json, and add this inside mcpServers:

"arugula": {
  "url": "https://mcp.arugulanet.com/mcp?ch=lm-studio"
}

Any other MCP client: use https://mcp.arugulanet.com/mcp with the Streamable HTTP transport and no authentication.

The entry for the official MCP registry is server.json (com.arugulanet/arugula).

Open @ArugulaNetBot and say what you want. To use it with others, add it to a group. To use it in any chat, type @ArugulaNetBot followed by your request.

Site search

One line on any page with a search box. When a visitor searches, offers that fit show up under your search form. The script sets no cookies.

<script async src="https://api.arugulanet.com/embed/v0.5.3/search.js"
        integrity="sha384-zA3WSKKc0LPhJbRva74fnPt5eNSe2c39gzLc9uH744kZoujIak40WE87iwYlkcbA"
        crossorigin="anonymous" data-channel="site-search"></script>

It finds your search box by itself: input[type=search], a search form, or an input named q, s, search or query. All of these attributes are optional:

Attribute	What it sets	Default
`data-selector`	Your search input, for example `#q`	Found automatically
`data-container`	Where the offers go	Right after the search form
`data-limit`	How many offers to show	3
`data-region`	Your market, as a country code (for example `SG`). Offers available there come first	The visitor's country

The hashes for each release are at https://api.arugulanet.com/embed/v0.5.3/integrity.json. Each release path never changes.

Shopify

In your theme, open Edit code, then layout/theme.liquid, and paste this just before </body>:

<script async src="https://api.arugulanet.com/embed/v0.5.3/search.js"
        integrity="sha384-zA3WSKKc0LPhJbRva74fnPt5eNSe2c39gzLc9uH744kZoujIak40WE87iwYlkcbA"
        crossorigin="anonymous" data-channel="shopify"></script>

It attaches to your store's search the same way as site search.

Google Tag Manager

The tag template is template.tpl in this repository. It loads the site-search script.

In GTM, open Templates, then New under Tag Templates.
Open the menu at the top right, choose Import, and select template.tpl. Save.
Add a new tag of type Arugula that fires on All Pages. Publish the container.

You can also download the template as a ZIP from https://api.arugulanet.com/arugula-gtm-template.zip.

WordPress

Download arugula-wordpress.zip. In WordPress, open Plugins, then Add New, then Upload Plugin. Choose the file and activate it. It attaches to your site's search with nothing to set up. The plugin's readme.txt lists everything it sends and stores.

Cloudflare Zaraz and Workers

Three ways in, all in cloudflare/:

Zaraz Custom HTML: add a Custom HTML tool with the site search snippet, using data-channel="zaraz", and give it a Pageview action.
Zaraz Custom Managed Component: deploy cloudflare/component as a Worker with npx managed-component-to-cloudflare-worker ./index.js arugula, then add it under Third-party tools.
Cloudflare Worker for sites on Cloudflare without Zaraz: cloudflare/worker adds the script at the edge (npx wrangler deploy).

The script runs once per page even when Zaraz fires on every single-page navigation.

Chatbots

A bot you already run can forward a user's message to Arugula and show the offers that come back:

POST https://api.arugulanet.com/v1/partner/intents
Authorization: Bearer <partner key>

{"text": "a linen sofa under S$1,500", "user_id": "<your user's id>"}

The answer has offers, each with a tracked_url, and a ready-made text reply. For Chatwoot, set the agent bot's webhook to https://api.arugulanet.com/hooks/chatwoot/<partner id>?key=<partner key>. To get a partner key, open an issue.

Python

arugulanet on PyPI. Needs Python 3.9 or later, has no dependencies, and needs no account.

pip install arugulanet

from arugulanet import Arugula

offers = Arugula().find_offers("a hotel room in Singapore for two nights", party_size=2)

If you know your user's country, pass it: Arugula(country="SG"). Offers available there come first.

For LangChain and LangGraph, install "arugulanet[langchain]" or "arugulanet[langgraph]" and use from arugulanet.langchain import find_offers_tool. For CrewAI, install "arugulanet[crewai]" and use from arugulanet.crewai import FindOffersTool.

JavaScript

Coming soon to npm as arugulanet. Needs Node 18 or later and has no runtime dependencies. Includes tools for OpenAI function calling, LangChain.js and CrewAI-style agents.

import { Arugula } from "arugulanet";

const offers = await new Arugula().findOffers("a hotel room in Singapore for two nights", { party_size: 2 });

Showing offers

If you build on Arugula, show this line with the offers:

Ranked by fit only. Arugula may earn a commission if you buy through these links, at no extra cost to you.

The tools and the API return it with every list of offers, as disclosure.

Brand

Logos, icons, avatars, favicons and social images are in brand/, with the rules in brand/BRAND.md. Use them as they are: no recolouring, outlines or effects.

Help

Questions, problems and requests: open an issue.

Licence

This repository is under the Apache License 2.0. The packages carry their own licences: MIT for the Python and JavaScript packages, and GPLv2 or later for the WordPress plugin.

Arugula

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Arugula?

Does Arugula need an API key?

What transport does Arugula use?

When was Arugula last checked?

Documentation

Arugula

Where to use it

MCP server

Telegram

Site search

Shopify

Google Tag Manager

WordPress

Cloudflare Zaraz and Workers

Chatbots

Python

JavaScript

Showing offers

Brand

Help

Licence