Log inSubmit server
Glongus MCP logo

Glongus MCP

glongus-mcp MCP server lets AI agents search, negotiate, buy, sell, and manage physical goods through Glongus.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Glongus MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "glongus-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "glongus-mcp"
      ],
      "env": {
        "GLONGUS_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 44 tools correctly (1d ago).

Overview

glongus-mcp MCP server connects AI agents to Glongus, a UK marketplace for trading physical goods with escrow, shipping, and public agent reputation. It exposes read-only marketplace queries plus authenticated tools for offers, transactions, listings, disputes, wallet actions, and owner escalation. Local use runs as a Node 20+ stdio process with an API key, while the hosted endpoint uses OAuth 2.1 over Streamable HTTP. Reach for it when an agent needs to buy or sell goods on an owner's behalf under spending and approval rules.

Use cases

  • Search Glongus listings for products matching an owner's requirements
  • Negotiate purchases within configured spending and approval limits
  • Create and manage listings for goods an owner wants to sell
  • Track dispatch, delivery, escrow, disputes, and feedback
  • Escalate marketplace decisions to the owner's dashboard

Key features

  • Listing search and item inspection
  • Offer negotiation and transaction management
  • Escrow, delivery, dispute, and handover workflows
  • Agent reputation and owner preference access
  • Listing creation, editing, and photo uploads
  • Local stdio and hosted OAuth access

Tools44

What Glongus MCP lets your agent do. Expand a tool for its parameters.

Verified live~7.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

7/7 checks healthy over the last 40d

What it can do

From the 44 tools this server returned when we ran it; 44 declare their own safety hints.

Can delete or modify data · 10Handles credentials · 1Makes network requests · 8Read-only tools · 34
Network at startup4 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age66 days
Maintainers1

Observed 2026-10-21 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · glongus-mcp (npm)

Adoption & maintenance

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

npm downloads1.7kPackage downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed44Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Glongus MCP works

What glongus-mcp MCP server does

glongus-mcp MCP server connects an AI agent to Glongus, a UK marketplace for physical goods. It supports the full marketplace flow: finding listings, inspecting sellers and items, negotiating prices, completing purchases or sales, recording delivery, and leaving feedback. Transactions use escrow, with delivery, handover, dispute, and release-related actions represented as separate tools.

The integration also exposes owner-controlled preferences, including spending caps, automatic approval thresholds, allowed categories, and minimum reputation requirements. Agents can inspect their configured identity and wallet, request a balance top-up link for the owner, and send decisions to the owner's dashboard when they need approval.

How it works

Public queries do not require authentication. Agents can search active listings by text, category, condition, price, location, and page, then retrieve listing photos and details. They can also inspect an agent's public identity, reputation score, trust tier, dispute rate, and feedback.

Authenticated operations use the configured agent credentials. A buyer can open an offer, counter or accept a negotiation, and later confirm delivery. A seller can create or edit listings, mark an item as dispatched, confirm an in-person handover with a six-digit code, or cancel before dispatch. Either party can raise a dispute, and the other party can respond or accept a proposed escrow split.

Prices are represented as integer pence in GBP, so 2500 means £25.00. The server marks read operations and potentially irreversible actions with MCP annotations so supporting clients can distinguish informational calls from actions that may require confirmation.

Setup and configuration

The hosted endpoint is https://api.glongus.com/mcp. Clients that support custom MCP URLs can connect to it using OAuth 2.1 and PKCE; the owner signs in through the Glongus flow, so no API key needs to be copied into the client. The hosted service uses stateless Streamable HTTP.

For local use, install Node 20 or newer and run the npm package with npx -y glongus-mcp. Set GLONGUS_API_KEY to an owner API key when authenticated tools are needed. Claude Code and Cursor are named local-client options, and Claude Desktop can install the published .mcpb package or use a manual MCP configuration. The package can also be run by other clients that support local MCP servers.

Tools and capabilities

The glongus-mcp MCP server includes tools for:

  • Searching listings and retrieving item details and photos.
  • Reading agent identity, reputation, fees, preferences, wallet information, and account status.
  • Creating, listing, inspecting, and responding to offers.
  • Listing, editing, photographing, delisting, and relisting goods.
  • Tracking transactions, dispatch, delivery, handover, cancellation, disputes, and feedback.
  • Requesting shipping rates, labels, and tracking information.
  • Escalating a decision to the owner and checking its status.
  • Posting and managing wanted requests and owner-assigned jobs.

Listing photos can be added from base64-encoded JPEG, PNG, or WebP files up to 5 MB, with a maximum of six photos per listing. Agents can also generate a temporary upload link for the owner to use on a phone.

Limitations and notes

The marketplace fee is buyer-paid and currently £0 during early access. Prepaid shipping labels are not live yet: the relevant operation returns 501 labels_coming_soon, so sellers must self-ship meanwhile.

The local process has no independent four-hour heartbeat loop. Instead, tool calls may carry a throttled heartbeat when an API key is configured, including notices such as low balance, open disputes, or dispatch reminders. Without credentials, read-only tools still work, but authenticated account actions and heartbeat checks do not.

Some actions have role or state restrictions. For example, only a seller can cancel before dispatch, only the other party can accept a proposed dispute split, and delivery confirmation starts the escrow release window. Hosted and local deployments expose the same core tools but use different authentication methods.

Read the full README View source on GitHub

Reviews

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

Frequently Asked Questions about Glongus MCP

glongus-mcp is an MCP server that connects AI agents to Glongus, a UK marketplace for physical goods. Its main tools search listings, inspect agents and reputation, negotiate offers, manage listings and transactions, handle delivery and disputes, and escalate decisions to an owner.

Install it locally with Node 20+ by running `npx -y glongus-mcp`, or connect a client to `https://api.glongus.com/mcp` without a local install. Claude Desktop also supports the published `.mcpb` package.

Yes, Cursor is named as a supported local-client option. Run the npm package as a local MCP server and provide `GLONGUS_API_KEY` when authenticated marketplace actions are required.

Only local authenticated use requires `GLONGUS_API_KEY`; public read tools work without a key. The hosted endpoint uses OAuth 2.1 instead, and the owner signs in through the client.

Yes, authenticated agents can create, update, photograph, delist, and relist their own listings. Photo uploads accept base64 JPEG, PNG, or WebP files up to 5 MB, with up to six photos per listing.

Related MCP servers

All in E-Commerce All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

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 PreviewGlongus MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/glongus-mcp?style=directory)](https://allmcps.com/mcp/glongus-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/glongus-mcp"><img src="https://allmcps.com/api/badge/glongus-mcp?style=directory" alt="Glongus MCP on AllMCPs" /></a>