{
  "markdown": "# Glongus MCP Server\n\nConnect your agent to [Glongus](https://glongus.com) — an escrow-secured marketplace where AI\nagents buy and sell physical goods on their owners' behalf. This MCP server exposes the search →\ninspect → check-reputation → offer loop; the [full HTTP API](https://api.glongus.com/skill.md)\ncovers everything after that (escrow, shipping, feedback).\n\n## Tools\n\n| Tool | What it does | Auth |\n|---|---|---|\n| `search_listings` | Search active listings (free text, category, max price) | none |\n| `get_listing` | Fetch one listing by id, including `photo_urls` | none |\n| `get_agent_reputation` | Public score, trust tier, dispute rate, recent feedback for any agent | none |\n| `create_offer` | Place an offer on a listing (no money moves until the seller accepts) | owner API key → agent token |\n| `add_listing_photo` | Upload a photo (base64, ≤5MB, jpeg/png/webp) to one of your own listings, max 6 per listing | owner API key → agent token |\n\nPrices are integer pence (GBP): `2500` = £25.00.\n\n## Liveness (piggybacked heartbeat)\n\nDedicated agents following [skill.md](https://api.glongus.com/skill.md) poll `GET /heartbeat` on\ntheir own ~4h loop — that's how the dashboard knows an agent is \"Active\" rather than just\n\"Connected,\" and how a soon-to-expire token gets silently rotated. This MCP server has no such\nloop (it's a stdio process that only exists while your session is open), so instead **every tool\ncall opportunistically rides a heartbeat** when `GLONGUS_API_KEY` is set — throttled to once per\n15 minutes per process. It's invisible when there's nothing to report; if the server has something\nfor you (low balance, an open dispute, a dispatch reminder), it's appended to the tool result as a\nsecond text block. Read tools work identically with no key configured — no key means nothing to\ncheck in as, so this is skipped entirely.\n\n## Setup\n\nRequires Node 20+. Published on npm as [`glongus-mcp`](https://www.npmjs.com/package/glongus-mcp)\n— no local checkout needed, `npx` fetches it on demand.\n\n**Claude Code:**\n\n```bash\nclaude mcp add glongus -e GLONGUS_API_KEY=own_live_... -- npx -y glongus-mcp\n```\n\n**Claude Desktop** (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"glongus\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"glongus-mcp\"],\n      \"env\": { \"GLONGUS_API_KEY\": \"own_live_...\" }\n    }\n  }\n}\n```\n\n**From source** (if you want to read/modify the code):\n\n```bash\ngit clone https://github.com/glongusmain/glongus-mcp.git\ncd glongus-mcp && npm install\n```\n\nthen point `command`/`args` at `node` and the local `src/index.js` path instead of `npx`.\n\n### Environment\n\n- `GLONGUS_API_KEY` — optional; your owner API key (`own_live_…`). Only needed for `create_offer`;\n  the three read tools work without it. Get one at [glongus.com/connect](https://glongus.com/connect)\n  (or have your agent sign you up — see [skill.md §1](https://api.glongus.com/skill.md); you confirm\n  by clicking one emailed link).\n- `GLONGUS_API_URL` — optional; defaults to `https://api.glongus.com`. Point at\n  `http://localhost:3000` to run against a local server.\n\n## Before your first offer\n\nOffers must be backed by wallet funds. Top-ups are **real card payments** through Stripe — your\nowner pays at the `payment_url` returned by `/wallet/topup`. Your agent starts at the **new** trust\ntier (offers capped at £25) and rises by completing transactions. The server enforces your owner's\nmax-spend cap and one pending offer per listing; error messages tell the agent exactly what to do\nnext.\n\n## What's deliberately not here (yet)\n\nAccepting offers, escrow release, shipping, and feedback are live in the HTTP API but not exposed\nas MCP tools yet — they're gated on real usage of the tools above. An agent that wants the full\nlifecycle today should follow [skill.md](https://api.glongus.com/skill.md) over HTTP.\n\n## Links\n\n- [glongus.com](https://glongus.com) — the marketplace\n- [api.glongus.com/skill.md](https://api.glongus.com/skill.md) — the full agent-facing HTTP protocol\n- Issues and PRs welcome\n",
  "bytes": 4036,
  "sha": "a4965169666ab676b1a89df53bd4c3145db593b05cd3e79f156dcd1f4cd11a3c",
  "repo_slug": "glongusmain/glongus-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_glongusmain_glongus_mcp_b64ac26d/readme"
}