uex-market-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@uex-market-mcp find recent Stileron listings above 800 quality in Stanton"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
uex-market-mcp
Search the UEX player marketplace of Star Citizen from Claude, or any MCP client, with combined filters:
List recent listings of Stileron sellers with quality above 800.
One call combines item, quality range, age, price, star system, location, seller, title words and category, ranked by quality, recency or price, one listing per seller, each with a direct link.
Read-only, public data, no UEX account and no secret needed.
Use it
Hosted instance (free, public, rate limited): https://uex.cavalera.news/mcp
Claude web / desktop / mobile: Settings > Connectors > Add custom connector, paste the URL.
Claude Code:
claude mcp add --transport http uex-market https://uex.cavalera.news/mcp
Local, no third-party server (needs uv):
{
"mcpServers": {
"uex-market": {
"command": "uvx",
"args": ["--from", "git+https://github.com/jbillochon/uex-market-mcp", "uex-market-mcp"]
}
}
}or claude mcp add uex-market -- uvx --from git+https://github.com/jbillochon/uex-market-mcp uex-market-mcp.
Calls then go from your machine straight to the UEX API.
Skill: skill/uex-marketplace/SKILL.md teaches Claude how to turn a
request into filters and how to read quality labels. Zip the
uex-marketplace folder and add it in Claude (Settings > Capabilities >
Skills), or copy it to ~/.claude/skills/ for Claude Code.
Related MCP server: shopping-mcp
Tools
Tool | Purpose |
| Filtered, ranked listings. Main tool. |
| Typo-tolerant lookup in the UEX catalog (about 7 800 items). |
| Catalog and cache freshness, UEX call budget. |
How quality is read
Sellers often leave the quality field empty or at its default, and write
the real value in the title (Dolivine 886Q, Q965, 550-676q). Each
result says where its quality comes from:
Label | Meaning |
| declared by the seller |
| read from the title or description |
| one listing offering several qualities (filtered on the range) |
| the form default, not confirmed |
| unknown, never passes a quality threshold |
The parser abstains rather than guess: prices, volumes and quantities
(585 400 000, 32 SCU, x50) are not read as qualities.
Data and limits
Per item: every active listing (up to 1 000), live from the UEX API, cached 10 minutes.
Listings published without an item id (about one in seven) are found by title among the latest 1 000 listings of the marketplace, polled at most every 5 minutes and kept for 21 days.
A search without an item covers that recent window only.
Sold-out and expired listings are dropped.
Outgoing UEX traffic is capped per process (
UEX_MAX_CALLS_PER_MIN, default 40), whatever the incoming load.
Self-hosting over HTTP
pip install git+https://github.com/jbillochon/uex-market-mcp
UEX_MCP_ALLOWED_HOSTS=uex.example.org uex-market-mcp --http --port 8792Stateless Streamable HTTP on 127.0.0.1:8792/mcp, /health for probes.
Put it behind a TLS reverse proxy; deploy/ has a systemd unit and an nginx
example with rate limiting.
Variable | Default | |
| public host names accepted (DNS rebinding protection) | |
|
| catalog cache |
|
| outgoing UEX budget |
| optional UEX token, for a quota of your own | |
| off |
|
| public base URL, required by the OAuth facade | |
|
| redirect hosts accepted by the facade |
claude.ai and OAuth. claude.ai custom connectors run OAuth discovery and
dynamic client registration on "Connect" even for servers without
authentication, and fail when there is no registration endpoint
(anthropics/claude-ai-mcp#457).
UEX_MCP_OAUTH_SHIM=1 answers that flow with an auto-approving facade: any
client registers, /authorize redirects straight back, /token issues a
token that grants nothing more, since /mcp stays open to everyone. Redirect
URIs are restricted to an allowlist so /authorize is not an open redirector.
Development
python -m unittest discover -s testsNot affiliated with UEX Corp or Cloud Imperium Games. Trades happen between players: check the seller before paying.
MIT License.
Available Tools
3 toolsfind_itemsFind UEX itemsARead-onlyIdempotent
Look up items in the UEX catalog by name (typo tolerant) to get their exact names and ids before searching listings.
Inputs: query (required), limit, category.
marketplace_statusMarketplace data statusBRead-onlyIdempotent
Freshness of the catalog and caches, and the UEX call budget.
Inputs: no named parameters.
search_listingsSearch marketplace listingsARead-onlyIdempotent
Find player listings on the UEX marketplace with combined filters (item, quality range, age, price, system, location, seller, title words, category), ranked by quality, recency or price. Each result has a direct link to the listing.
Inputs: item, sort, text, limit, +12 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct role: find_items resolves catalog items, search_listings queries marketplace listings, and marketplace_status reports cache freshness/budget. There is no practical overlap that would cause misselection.
All names use snake_case, and search_listings/find_items follow a clear verb_noun pattern. marketplace_status deviates slightly as a noun phrase, but the set remains readable and predictable.
Three tools is modest but appropriate for a focused, read-only marketplace search server. Each tool serves a clear purpose, though the surface is on the minimal side.
The set covers item lookup, listing search, and cache status, but lacks direct retrieval of listing details by ID or deeper item details. Relying on external links for listing details is a notable gap for an agent-driven workflow.
Related MCP Connectors
Search and browse global classifieds across 80 markets. No auth required for read-only access.
Live eBay prices, sellers and profit for any keyword on 8 eBay sites. Pay per call with x402 USDC.
Federated listings from personal humanMCP servers. Search offers, trades by humans.
Open, permissionless discovery marketplace for x402-payable resources. No account or KYC required.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to search and retrieve listings from Sweden's largest second-hand marketplaces, Blocket and Tradera. Returns unified data including prices, images, seller information, and direct links to listings.9MIT
- AlicenseAqualityDmaintenanceRead-only eBay search and listing lookup via the official Browse API, with filters for price, condition, buying format, shipping, and deals.4MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to search live musical-instrument marketplace listings — guitars, amps, pedals, synths, drums and pro audio — filtering by make, model, category, condition, price band, year and region, and to pull full listing detail, seller profiles and the category tree. It returns current asking prices only, with no realized sold-transaction data.307 npmMIT
- AlicenseAqualityCmaintenanceEnables AI agents to search public classified listings and read individual listing details through a local browser session, with filters for location, radius, price, and sort order. Read-only and user-directed: no login, no account, no messaging, and no bulk scraping.222 npm1MIT