qloo-mcp
Allows the Taste Match agent to optionally call an OpenAI-compatible LLM endpoint to suggest additional influences and style keywords for a described work, augmenting artist-supplied seeds.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
qloo-mcp
An MCP server that gives any AI agent the Qloo Taste AI graph as tools, plus Taste Match, an agent that tells an independent artist exactly who would love a piece from their catalog.
Built for the Qloo Agentic Hackathon: https://qloo.devpost.com/
Why
Independent artists sell to "people who like this kind of thing" and have no way to say who those people are. A generic LLM can guess. Qloo knows: its taste graph links 250M+ artists, films, books, brands and places to real affinity data, demographics and locations. Taste Match turns one description of a print or a song into:
the artists, films, books and brands its audience already loves
the places in a chosen city where those people go (galleries, cafes, shops, venues)
the age and gender affinity of that audience
the words that describe that taste
a ready-to-use plain-text pitch
Related MCP server: Booker
Tools
Tool | Qloo endpoint | What it does |
| GET /search | Resolve names to Qloo entity IDs across artists, books, brands, destinations, movies, people, places, podcasts, TV shows, video games |
| GET /v2/tags | Resolve genre, style or keyword names to Qloo tag IDs |
| GET /v2/audiences | List audience segments by audience type |
| GET /v2/insights | Taste-based recommendations of one entity type from entity, tag, age, gender, audience and location signals |
| GET /v2/insights (urn:demographics) | Age and gender affinity of the audience for entities or tags |
| GET /v2/insights (urn:tag) | Tags that describe the taste of an entity set, audience or location |
| all of the above | Composite agent: description in, audience report and pitch out |
Every tool validates input with Pydantic and returns JSON. Failures come back as structured errors (invalid_input, missing_api_key, qloo_api_error, unknown_tool), never tracebacks.
How Taste Match works
Plan. The artist gives a title, a description, and optionally influences and style keywords. If an OpenAI-compatible LLM is configured (
TASTE_MATCH_LLM_URL), the agent asks it for more influences and keywords. Without one, a deterministic keyword extractor fills in. Artist-supplied seeds always win.Resolve. Every seed is looked up in Qloo in parallel (
/searchfor entities,/v2/tagsfor tags) to get real Qloo IDs.Fan out. Seven parallel Qloo insight calls: artists, places (restricted to the chosen city), brands, books, movies, demographics, taste tags.
Synthesize. Seeds are removed from results, demographics are averaged into an audience profile, and a plain-text pitch is written from the top matches.
One failing branch becomes a note in the result instead of failing the whole match.
Install
Requires Python 3.11+.
git clone https://github.com/NoBanks/qloo-mcp
cd qloo-mcp
python3.11 -m pip install -e .Configuration
Env var | Required | Default |
| yes | none. Request one: https://docs.qloo.com/reference/qloo-llm-hackathon-developer-guide |
| no |
|
| no |
|
| no | unset (keyword planner). Any OpenAI-compatible |
| no | first model from |
| no | unset |
The key is sent only as the X-Api-Key header and is never logged.
Claude Desktop / any MCP client
{
"mcpServers": {
"qloo": {
"command": "qloo-mcp"
}
}
}Add QLOO_API_KEY to the environment the client launches the server with (in Claude Desktop, an env object inside the qloo entry).
Hackathon demo
The demo is a small web app plus a CLI, both driving the same taste_match agent the MCP tool uses.
Web app (the hosted demo)
python3.11 -m pip install -e ".[demo]"
export QLOO_API_KEY=... # your key
uvicorn demo.web_app:app --host 0.0.0.0 --port 8080Open http://localhost:8080, pick an example work (or describe your own), and press Find my audience.
Routes: GET / (UI), GET /api/catalog (example works), POST /api/match (runs Taste Match), GET /healthz. POST /api/match is rate limited per IP (TASTE_MATCH_RATE_PER_MIN, default 10).
Deploy anywhere that runs a container. The included Dockerfile serves the app on $PORT:
docker build -t taste-match .
docker run -p 8080:8080 -e QLOO_API_KEY=... taste-matchCLI agent
export QLOO_API_KEY=...
python3.11 demo/taste_match_agent.py # every work in demo/catalog.json
python3.11 demo/taste_match_agent.py --index 2 # one work
python3.11 demo/taste_match_agent.py --title "Neon Koi" --kind artwork \
--description "Glowing koi in a night pond, ukiyo-e meets cyberpunk" \
--influences "Hokusai,Blade Runner" --location "Seattle"Add --json for the raw result.
Tests
python3.11 -m pip install -e ".[dev,demo]"
python3.11 -m pytest tests/ -vAll HTTP is mocked with respx. No key or network is needed to run the suite.
License
MIT. See LICENSE.
Built by Ryan Hammer (NoBanks): https://github.com/NoBanks
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Trend data, an interactive Trend Radar and ad-targeting dry runs for AI agents. Read-only.
TikTok search demand, videos, creators, comments and captions for AI agents. OAuth or API key.
Search, analyze, and discover commercially released music using sonic intelligence.
TikTok research for AI agents. Ask ChatGPT, Claude, Cursor, Codex or any MCP client what people search, watch, say and buy on TikTok, and get real numbers back. 34 tools: weekly TikTok search volume and 7-day trends, content gaps, videos, creators, comments and caption transcripts, hashtags and sounds, TikTok Shop sales estimates for products, shops, creators, videos and LIVE streams, TikTok’s Top Ads library with CTR and retention, places, and a fair comment-giveaway picker. 17 markets. Built for marketers, agencies, TikTok Shop sellers and creators. Sign in with OAuth or an API key; 50 free credits, no card.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides cross-media recommendations from TasteDive, enabling AI agents to discover related music, movies, TV shows, books, games, and podcasts through a free API key.11 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables venues to discover taste-matched acts and artists or agents to find fitting rooms and cities through Qloo's taste graph. It exposes booking-focused tools for agent use over a remote MCP endpoint.4 npmMIT
- AlicenseNot gradedqualityBmaintenanceExposes Qloo taste-graph analysis of a restaurant's audience as MCP tools, letting existing agents retrieve a restaurant's entity, cross-domain affinities, over-indexing dishes and vibes, and demographic skew, or generate a fully verified weekly playbook of menu moves, events, and campaigns. Enables agents to ground restaurant decisions in Qloo evidence with affinity scores and an evidence ledger.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to find movies, shows, books, music, podcasts, games, places, destinations, or brands that two people are likely to enjoy together. It resolves favorites to Qloo entities, compares taste profiles, ranks candidates for fairness, and returns explainable matches through five read-only tools.MIT