knos
The neutral meter for AI agent work: neither side keeps the count.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"knos": {
"command": "uvx",
"args": [
"knos"
]
}
}
}실행 가능한 패키지
0.4.0stdio원격 엔드포인트
https://knos.onrender.com/mcpstreamable-http할 수 있는 일
도구 목록
도구 (26)
🔴knos_cross(ref, idea, place, product, age, ...)
Turns a paper id (DOI, arXiv, PubMed or OpenAlex) into a research card and a demand check, and returns each step with the Qloo call behind it.
입력 스키마
{
"type": "object",
"properties": {
"ref": {
"type": "string"
},
"idea": {
"type": "string"
},
"place": {
"type": "string"
},
"product": {
"type": "string"
},
"age": {
"type": "string",
"description": "Who wants it (F1): Who: age range(s) the answer is weighted to. Qloo: signal.demographics.age. comma-separated, of: 24_and_younger, 25_to_29, 30_to_34, 35_to_44, 45_to_54, 55_and_older",
"examples": [
"35_to_44"
]
},
"gender": {
"type": "string",
"enum": [
"male",
"female"
],
"description": "Who wants it (F1): Who: gender the answer is weighted to. Qloo: signal.demographics.gender.",
"examples": [
"female"
]
},
"audiences": {
"type": "string",
"description": "Who wants it (F1): Audience segment ids (from /v2/audiences). Qloo: signal.demographics.audiences.",
"examples": [
"urn:audience:hobbies_and_interests:running"
]
},
"interests_names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Who wants it (F1): Steer the answer by things you name (Qloo resolves them; sent as JSON). Qloo: signal.interests.entities.query. names, or one comma-separated string",
"examples": [
"Hoka, Salomon"
]
},
"audiences_weight": {
"type": "string",
"enum": [
"low",
"medium",
"high",
"higher"
],
"description": "Who wants it (F1): How much the segments steer the answer. Qloo: signal.demographics.audiences.weight.",
"examples": [
"high"
]
},
"hide_leader": {
"type": "boolean",
"description": "What is underserved (F2): Gaps: hide the market leader (its Qloo id is excluded). Qloo: filter.exclude.entities.",
"examples": [
true
]
},
"exclude": {
"type": "string",
"description": "What is underserved (F2): Entity ids to leave out. Qloo: filter.exclude.entities.",
"examples": [
"4BBEF799-A0C4-4110-AB01-39216993C312"
]
},
"exclude_names": {
"type": "array",
"items": {
"type": "string"
},
"description": "What is underserved (F2): Leave out things by name (Qloo resolves them; sent as JSON). Qloo: filter.exclude.entities.query. names, or one comma-separated string",
"examples": [
"Nike, Adidas"
]
},
"exclude_tags": {
"type": "string",
"description": "What is underserved (F2): Tag ids to leave out. Qloo: filter.exclude.tags.",
"examples": [
"urn:tag:genre:media:horror"
]
},
"exclude_tags_operator": {
"type": "string",
"enum": [
"union",
"intersection"
],
"description": "What is underserved (F2): Leave out results with any (union) or all (intersection) of those tags. Qloo: operator.exclude.tags.",
"examples": [
"union"
]
},
"popularity_max": {
"type": "number",
"description": "What is underserved (F2): Gaps: niche only, popularity at most this percentile (0-1). Qloo: filter.popularity.max.",
"examples": [
0.5
]
},
"popularity_min": {
"type": "number",
"description": "What is underserved (F2): Popularity at least this percentile (0-1). Qloo: filter.popularity.min.",
"examples": [
0.1
]
},
"results_query": {
"type": "string",
"description": "What is underserved (F2): Score only these named things (one name). Qloo: filter.results.entities.query.",
"examples": [
"Fitbit"
]
},
"near": {
"type": "string",
"description": "Where to launch (F3): Where: a city or region by name. Qloo: filter.location.query.",
"examples": [
"Austin"
]
},
"radius": {
"type": "integer",
"description": "Where to launch (F3): Where: radius around it, in meters (0 = strictly inside). Qloo: filter.location.radius.",
"examples": [
5000
]
},
"location": {
"type": "string",
"description": "Where to launch (F3): A WKT POINT/POLYGON (longitude first) or a locality id. Qloo: filter.location.",
"examples": [
"POINT(-97.7431 30.2672)"
]
},
"geohash": {
"type": "string",
"description": "Where to launch (F3): Only results whose geohash starts with this. Qloo: filter.location.geohash.",
"examples": [
"9v6k"
]
},
"exclude_near": {
"type": "string",
"description": "Where to launch (F3): Leave out an area by name. Qloo: filter.exclude.location.query.",
"examples": [
"Downtown Austin"
]
},
"exclude_location": {
"type": "string",
"description": "Where to launch (F3): Leave out a WKT area or locality id. Qloo: filter.exclude.location.",
"examples": [
"POINT(-97.74 30.27)"
]
},
"exclude_geohash": {
"type": "string",
"description": "Where to launch (F3): Leave out results whose geohash starts with this. Qloo: filter.exclude.location.geohash.",
"examples": [
"9v6kp"
]
},
"city": {
"type": "string",
"description": "Where to launch (F3): Exact city or town name. Qloo: filter.geocode.name.",
"examples": [
"Austin"
]
},
"admin1": {
"type": "string",
"description": "Where to launch (F3): Exact state or region. Qloo: filter.geocode.admin1_region.",
"examples": [
"Texas"
]
},
"admin2": {
"type": "string",
"description": "Where to launch (F3): Exact county or borough. Qloo: filter.geocode.admin2_region.",
"examples": [
"Travis County"
]
},
"country": {
"type": "string",
"description": "Where to launch (F3): Two-letter country code. Qloo: filter.geocode.country_code.",
"examples": [
"US"
]
},
"price_level": {
"type": "string",
"description": "At what price, where (F4): Price tier: 1 (cheap) to 4 (dear), mapped where it is hot. Qloo: filter.dimensions.price_level. comma-separated, of: 1, 2, 3, 4",
"examples": [
"1"
]
},
"hotel_class": {
"type": "string",
"description": "At what price, where (F4): Hotel classes 1-5, mapped where they are hot. Qloo: filter.dimensions.hotel_class. comma-separated, of: 1, 2, 3, 4, 5",
"examples": [
"4,5"
]
},
"price_from": {
"type": "integer",
"description": "At what price, where (F4): Hotel price range from (0-1,000,000). Qloo: filter.price_range.from.",
"examples": [
100
]
},
"price_to": {
"type": "integer",
"description": "At what price, where (F4): Hotel price range to (0-1,000,000). Qloo: filter.price_range.to.",
"examples": [
300
]
},
"price_level_min": {
"type": "integer",
"description": "At what price, where (F4): Places at price level at least (1-4). Qloo: filter.price_level.min.",
"examples": [
2
]
},
"price_level_max": {
"type": "integer",
"description": "At what price, where (F4): Places at price level at most (1-4). Qloo: filter.price_level.max.",
"examples": [
3
]
},
"hotel_class_min": {
"type": "integer",
"description": "At what price, where (F4): Hotel class at least (1-5). Qloo: filter.hotel_class.min.",
"examples": [
3
]
},
"hotel_class_max": {
"type": "integer",
"description": "At what price, where (F4): Hotel class at most (1-5). Qloo: filter.hotel_class.max.",
"examples": [
5
]
},
"business_rating_min": {
"type": "number",
"description": "At what price, where (F4): Business rating at least. Qloo: filter.properties.business_rating.min.",
"examples": [
3.5
]
},
"business_rating_max": {
"type": "number",
"description": "At what price, where (F4): Business rating at most. Qloo: filter.properties.business_rating.max.",
"examples": [
5
]
},
"references_brand": {
"type": "string",
"description": "Who serves or stocks it (F5): Who serves it: a brand by name or id; only places tied to it. Qloo: filter.references_brand.",
"examples": [
"Whole Foods Market"
]
},
"quality": {
"type": "string",
"enum": [
"low",
"medium",
"high"
],
"description": "Who serves or stocks it (F5): Lean the ranking toward quality places. Qloo: bias.quality.",
"examples": [
"high"
]
},
"sort": {
"type": "string",
"enum": [
"affinity",
"distance",
"rating",
"quality"
],
"description": "Who serves or stocks it (F5): Order places by. Qloo: sort_by.",
"examples": [
"quality"
]
},
"open_on": {
"type": "string",
"description": "Who serves or stocks it (F5): Open on this day. Qloo: filter.hours.",
"examples": [
"Sunday"
]
},
"address": {
"type": "string",
"description": "Who serves or stocks it (F5): Address contains. Qloo: filter.address.",
"examples": [
"Congress Ave"
]
},
"tripadvisor_rating_min": {
"type": "number",
"description": "Who serves or stocks it (F5): Tripadvisor rating at least. Qloo: filter.external.tripadvisor.rating.min.",
"examples": [
4
]
},
"tripadvisor_rating_max": {
"type": "number",
"description": "Who serves or stocks it (F5): Tripadvisor rating at most. Qloo: filter.external.tripadvisor.rating.max.",
"examples": [
5
]
},
"tripadvisor_count_min": {
"type": "integer",
"description": "Who serves or stocks it (F5): Tripadvisor reviews at least. Qloo: filter.external.tripadvisor.rating.count.min.",
"examples": [
100
]
},
"tripadvisor_count_max": {
"type": "integer",
"description": "Who serves or stocks it (F5): Tripadvisor reviews at most. Qloo: filter.external.tripadvisor.rating.count.max.",
"examples": [
5000
]
},
"resy_rating_min": {
"type": "number",
"description": "Who serves or stocks it (F5): Resy rating at least (1-5). Qloo: filter.external.resy.rating.min.",
"examples": [
4
]
},
"resy_rating_max": {
"type": "number",
"description": "Who serves or stocks it (F5): Resy rating at most (1-5). Qloo: filter.external.resy.rating.max.",
"examples": [
5
]
},
"resy_count_min": {
"type": "integer",
"description": "Who serves or stocks it (F5): Resy rating count at least. Qloo: filter.external.resy.count.min.",
"examples": [
100
]
},
"resy_count_max": {
"type": "integer",
"description": "Who serves or stocks it (F5): Resy rating count at most. Qloo: filter.external.resy.count.max.",
"examples": [
10000
]
},
"resy_party_min": {
"type": "integer",
"description": "Who serves or stocks it (F5): Resy party size at least. Qloo: filter.external.resy.party_size.min.",
"examples": [
2
]
},
"resy_party_max": {
"type": "integer",
"description": "Who serves or stocks it (F5): Resy party size at most. Qloo: filter.external.resy.party_size.max.",
"examples": [
8
]
},
"external": {
"type": "string",
"description": "Who serves or stocks it (F5): Listed on these (resy, michelin, tablet). Qloo: filter.external.exists. comma-separated, of: resy, michelin, tablet",
"examples": [
"resy"
]
},
"external_operator": {
"type": "string",
"enum": [
"union",
"intersection"
],
"description": "Who serves or stocks it (F5): Any (union) or all (intersection) of those. Qloo: operator.filter.external.exists.",
"examples": [
"union"
]
},
"product_kind": {
"type": "string",
"enum": [
"film",
"tv",
"book",
"person",
"artist",
"brand",
"podcast",
"game",
"place",
"destination"
],
"description": "Media and people products (F6): Product kind: what the comparables are. Qloo: filter.type.",
"examples": [
"film"
]
},
"content_rating": {
"type": "string",
"description": "Media and people products (F6): Film/TV content rating(s), MPAA. Qloo: filter.content_rating.",
"examples": [
"PG-13"
]
},
"year_min": {
"type": "integer",
"description": "Media and people products (F6): Released from this year (film/TV; books: publication year). Qloo: filter.release_year.min.",
"examples": [
2015
]
},
"year_max": {
"type": "integer",
"description": "Media and people products (F6): Released up to this year (film/TV; books: publication year). Qloo: filter.release_year.max.",
"examples": [
2024
]
},
"release_country": {
"type": "string",
"description": "Media and people products (F6): Film/TV released in these countries. Qloo: filter.release_country.",
"examples": [
"United States"
]
},
"release_country_operator": {
"type": "string",
"enum": [
"union",
"intersection"
],
"description": "Media and people products (F6): Any (union) or all (intersection) of those. Qloo: operator.filter.release_country.",
"examples": [
"union"
]
},
"rating_min": {
"type": "number",
"description": "Media and people products (F6): Film/TV Qloo rating at least (0-5). Qloo: filter.rating.min.",
"examples": [
3.5
]
},
"rating_max": {
"type": "number",
"description": "Media and people products (F6): Film/TV Qloo rating at most (0-5). Qloo: filter.rating.max.",
"examples": [
5
]
},
"finale_year_min": {
"type": "integer",
"description": "Media and people products (F6): TV: final season from this year. Qloo: filter.finale_year.min.",
"examples": [
2018
]
},
"finale_year_max": {
"type": "integer",
"description": "Media and people products (F6): TV: final season up to this year. Qloo: filter.finale_year.max.",
"examples": [
2024
]
},
"latest_year_min": {
"type": "integer",
"description": "Media and people products (F6): TV: released or updated from this year. Qloo: filter.latest_known_year.min.",
"examples": [
2020
]
},
"latest_year_max": {
"type": "integer",
"description": "Media and people products (F6): TV: released or updated up to this year. Qloo: filter.latest_known_year.max.",
"examples": [
2025
]
},
"born_min": {
"type": "string",
"description": "Media and people products (F6): Person: born on or after (YYYY-MM-DD). Qloo: filter.date_of_birth.min.",
"examples": [
"1960-01-01"
]
},
"born_max": {
"type": "string",
"description": "Media and people products (F6): Person: born on or before (YYYY-MM-DD). Qloo: filter.date_of_birth.max.",
"examples": [
"1990-12-31"
]
},
"died_min": {
"type": "string",
"description": "Media and people products (F6): Person: died on or after (YYYY-MM-DD). Qloo: filter.date_of_death.min.",
"examples": [
"2000-01-01"
]
},
"died_max": {
"type": "string",
"description": "Media and people products (F6): Person: died on or before (YYYY-MM-DD). Qloo: filter.date_of_death.max.",
"examples": [
"2020-12-31"
]
},
"person_gender": {
"type": "string",
"enum": [
"male",
"female"
],
"description": "Media and people products (F6): Person: gender. Qloo: filter.gender.",
"examples": [
"female"
]
},
"lookup": {
"type": "string",
"description": "Look up exact things (F7): Look up exact things: a name to find (Search Entities). Qloo: query.",
"examples": [
"Austin"
]
},
"lookup_types": {
"type": "string",
"description": "Look up exact things (F7): What kinds to search. Qloo: types. comma-separated, of: urn:entity:actor, urn:entity:album, urn:entity:artist, urn:entity:author, urn:entity:book, urn:entity:brand, urn:entity:destination, urn:entity:director, urn:entity:locality, urn:entity:movie, urn:entity:person, urn:entity:place, urn:entity:podcast, urn:entity:tv_show, urn:entity:videogame",
"examples": [
"urn:entity:locality"
]
},
"lookup_near": {
"type": "string",
"description": "Look up exact things (F7): Search near: lat,lon or WKT. Qloo: filter.location.",
"examples": [
"30.2672,-97.7431"
]
},
"lookup_radius": {
"type": "number",
"description": "Look up exact things (F7): Search radius in miles (0-100). Qloo: filter.radius.",
"examples": [
10
]
},
"lookup_sort": {
"type": "string",
"enum": [
"match",
"distance",
"popularity"
],
"description": "Look up exact things (F7): Order the search by. Qloo: sort_by.",
"examples": [
"match"
]
},
"entity_id": {
"type": "string",
"description": "Look up exact things (F7): Look up exact things: paste a Qloo entity id (Search Entities by ID). Qloo: entity_ids.",
"examples": [
"B2A5BF4D-6D9A-4A8B-9E50-1A2B3C4D5E6F"
]
},
"qloo": {
"type": "object",
"additionalProperties": true,
"description": "Anything else in the guide (F8): Any other documented parameter for the call's filter.type, by its Qloo name. Qloo: *.",
"examples": [
{
"bias.trends": "high"
}
]
},
"qloo_calls": {
"type": "object",
"additionalProperties": true,
"description": "Anything else in the guide (F8): Calls to Qloo's other endpoints by path, each with its own documented parameters. Qloo: *.",
"examples": [
{
"/v2/tags": {
"filter.query": "trail running",
"feature.semantic_search": "true"
}
}
]
}
},
"additionalProperties": false
}🟢knos_research_card(ref)
Paper id -> the proven result (quoted), citations, retraction status, Nobel recognition, the product it enables.
입력 스키마
{
"type": "object",
"properties": {
"ref": {
"type": "string"
}
},
"required": [
"ref"
],
"additionalProperties": false
}🟢knos_demand_check(idea, picked, place, leader, age, ...)
Checks who wants a product idea with Qloo taste data and returns the verdict with its audience and launch city, each traced to its Qloo call.
입력 스키마
{
"type": "object",
"properties": {
"idea": {
"type": "string",
"description": "the product idea or a paper's DOI (8-500 characters)"
},
"picked": {
"type": "boolean",
"description": "true when idea is the exact reading picked from the readings a first call returned (which one do you mean?)"
},
"place": {
"type": "string",
"description": "the launch market"
},
"leader": {
"type": "string",
"description": "the market leader to compare"
},
"age": {
"type": "string",
"description": "Who wants it (F1): Who: age range(s) the answer is weighted to. Qloo: signal.demographics.age. comma-separated, of: 24_and_younger, 25_to_29, 30_to_34, 35_to_44, 45_to_54, 55_and_older",
"examples": [
"35_to_44"
]
},
"gender": {
"type": "string",
"enum": [
"male",
"female"
],
"description": "Who wants it (F1): Who: gender the answer is weighted to. Qloo: signal.demographics.gender.",
"examples": [
"female"
]
},
"audiences": {
"type": "string",
"description": "Who wants it (F1): Audience segment ids (from /v2/audiences). Qloo: signal.demographics.audiences.",
"examples": [
"urn:audience:hobbies_and_interests:running"
]
},
"interests_names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Who wants it (F1): Steer the answer by things you name (Qloo resolves them; sent as JSON). Qloo: signal.interests.entities.query. names, or one comma-separated string",
"examples": [
"Hoka, Salomon"
]
},
"audiences_weight": {
"type": "string",
"enum": [
"low",
"medium",
"high",
"higher"
],
"description": "Who wants it (F1): How much the segments steer the answer. Qloo: signal.demographics.audiences.weight.",
"examples": [
"high"
]
},
"hide_leader": {
"type": "boolean",
"description": "What is underserved (F2): Gaps: hide the market leader (its Qloo id is excluded). Qloo: filter.exclude.entities.",
"examples": [
true
]
},
"exclude": {
"type": "string",
"description": "What is underserved (F2): Entity ids to leave out. Qloo: filter.exclude.entities.",
"examples": [
"4BBEF799-A0C4-4110-AB01-39216993C312"
]
},
"exclude_names": {
"type": "array",
"items": {
"type": "string"
},
"description": "What is underserved (F2): Leave out things by name (Qloo resolves them; sent as JSON). Qloo: filter.exclude.entities.query. names, or one comma-separated string",
"examples": [
"Nike, Adidas"
]
},
"exclude_tags": {
"type": "string",
"description": "What is underserved (F2): Tag ids to leave out. Qloo: filter.exclude.tags.",
"examples": [
"urn:tag:genre:media:horror"
]
},
"exclude_tags_operator": {
"type": "string",
"enum": [
"union",
"intersection"
],
"description": "What is underserved (F2): Leave out results with any (union) or all (intersection) of those tags. Qloo: operator.exclude.tags.",
"examples": [
"union"
]
},
"popularity_max": {
"type": "number",
"description": "What is underserved (F2): Gaps: niche only, popularity at most this percentile (0-1). Qloo: filter.popularity.max.",
"examples": [
0.5
]
},
"popularity_min": {
"type": "number",
"description": "What is underserved (F2): Popularity at least this percentile (0-1). Qloo: filter.popularity.min.",
"examples": [
0.1
]
},
"results_query": {
"type": "string",
"description": "What is underserved (F2): Score only these named things (one name). Qloo: filter.results.entities.query.",
"examples": [
"Fitbit"
]
},
"near": {
"type": "string",
"description": "Where to launch (F3): Where: a city or region by name. Qloo: filter.location.query.",
"examples": [
"Austin"
]
},
"radius": {
"type": "integer",
"description": "Where to launch (F3): Where: radius around it, in meters (0 = strictly inside). Qloo: filter.location.radius.",
"examples": [
5000
]
},
"location": {
"type": "string",
"description": "Where to launch (F3): A WKT POINT/POLYGON (longitude first) or a locality id. Qloo: filter.location.",
"examples": [
"POINT(-97.7431 30.2672)"
]
},
"geohash": {
"type": "string",
"description": "Where to launch (F3): Only results whose geohash starts with this. Qloo: filter.location.geohash.",
"examples": [
"9v6k"
]
},
"exclude_near": {
"type": "string",
"description": "Where to launch (F3): Leave out an area by name. Qloo: filter.exclude.location.query.",
"examples": [
"Downtown Austin"
]
},
"exclude_location": {
"type": "string",
"description": "Where to launch (F3): Leave out a WKT area or locality id. Qloo: filter.exclude.location.",
"examples": [
"POINT(-97.74 30.27)"
]
},
"exclude_geohash": {
"type": "string",
"description": "Where to launch (F3): Leave out results whose geohash starts with this. Qloo: filter.exclude.location.geohash.",
"examples": [
"9v6kp"
]
},
"city": {
"type": "string",
"description": "Where to launch (F3): Exact city or town name. Qloo: filter.geocode.name.",
"examples": [
"Austin"
]
},
"admin1": {
"type": "string",
"description": "Where to launch (F3): Exact state or region. Qloo: filter.geocode.admin1_region.",
"examples": [
"Texas"
]
},
"admin2": {
"type": "string",
"description": "Where to launch (F3): Exact county or borough. Qloo: filter.geocode.admin2_region.",
"examples": [
"Travis County"
]
},
"country": {
"type": "string",
"description": "Where to launch (F3): Two-letter country code. Qloo: filter.geocode.country_code.",
"examples": [
"US"
]
},
"price_level": {
"type": "string",
"description": "At what price, where (F4): Price tier: 1 (cheap) to 4 (dear), mapped where it is hot. Qloo: filter.dimensions.price_level. comma-separated, of: 1, 2, 3, 4",
"examples": [
"1"
]
},
"hotel_class": {
"type": "string",
"description": "At what price, where (F4): Hotel classes 1-5, mapped where they are hot. Qloo: filter.dimensions.hotel_class. comma-separated, of: 1, 2, 3, 4, 5",
"examples": [
"4,5"
]
},
"price_from": {
"type": "integer",
"description": "At what price, where (F4): Hotel price range from (0-1,000,000). Qloo: filter.price_range.from.",
"examples": [
100
]
},
"price_to": {
"type": "integer",
"description": "At what price, where (F4): Hotel price range to (0-1,000,000). Qloo: filter.price_range.to.",
"examples": [
300
]
},
"price_level_min": {
"type": "integer",
"description": "At what price, where (F4): Places at price level at least (1-4). Qloo: filter.price_level.min.",
"examples": [
2
]
},
"price_level_max": {
"type": "integer",
"description": "At what price, where (F4): Places at price level at most (1-4). Qloo: filter.price_level.max.",
"examples": [
3
]
},
"hotel_class_min": {
"type": "integer",
"description": "At what price, where (F4): Hotel class at least (1-5). Qloo: filter.hotel_class.min.",
"examples": [
3
]
},
"hotel_class_max": {
"type": "integer",
"description": "At what price, where (F4): Hotel class at most (1-5). Qloo: filter.hotel_class.max.",
"examples": [
5
]
},
"business_rating_min": {
"type": "number",
"description": "At what price, where (F4): Business rating at least. Qloo: filter.properties.business_rating.min.",
"examples": [
3.5
]
},
"business_rating_max": {
"type": "number",
"description": "At what price, where (F4): Business rating at most. Qloo: filter.properties.business_rating.max.",
"examples": [
5
]
},
"references_brand": {
"type": "string",
"description": "Who serves or stocks it (F5): Who serves it: a brand by name or id; only places tied to it. Qloo: filter.references_brand.",
"examples": [
"Whole Foods Market"
]
},
"quality": {
"type": "string",
"enum": [
"low",
"medium",
"high"
],
"description": "Who serves or stocks it (F5): Lean the ranking toward quality places. Qloo: bias.quality.",
"examples": [
"high"
]
},
"sort": {
"type": "string",
"enum": [
"affinity",
"distance",
"rating",
"quality"
],
"description": "Who serves or stocks it (F5): Order places by. Qloo: sort_by.",
"examples": [
"quality"
]
},
"open_on": {
"type": "string",
"description": "Who serves or stocks it (F5): Open on this day. Qloo: filter.hours.",
"examples": [
"Sunday"
]
},
"address": {
"type": "string",
"description": "Who serves or stocks it (F5): Address contains. Qloo: filter.address.",
"examples": [
"Congress Ave"
]
},
"tripadvisor_rating_min": {
"type": "number",
"description": "Who serves or stocks it (F5): Tripadvisor rating at least. Qloo: filter.external.tripadvisor.rating.min.",
"examples": [
4
]
},
"tripadvisor_rating_max": {
"type": "number",
"description": "Who serves or stocks it (F5): Tripadvisor rating at most. Qloo: filter.external.tripadvisor.rating.max.",
"examples": [
5
]
},
"tripadvisor_count_min": {
"type": "integer",
"description": "Who serves or stocks it (F5): Tripadvisor reviews at least. Qloo: filter.external.tripadvisor.rating.count.min.",
"examples": [
100
]
},
"tripadvisor_count_max": {
"type": "integer",
"description": "Who serves or stocks it (F5): Tripadvisor reviews at most. Qloo: filter.external.tripadvisor.rating.count.max.",
"examples": [
5000
]
},
"resy_rating_min": {
"type": "number",
"description": "Who serves or stocks it (F5): Resy rating at least (1-5). Qloo: filter.external.resy.rating.min.",
"examples": [
4
]
},
"resy_rating_max": {
"type": "number",
"description": "Who serves or stocks it (F5): Resy rating at most (1-5). Qloo: filter.external.resy.rating.max.",
"examples": [
5
]
},
"resy_count_min": {
"type": "integer",
"description": "Who serves or stocks it (F5): Resy rating count at least. Qloo: filter.external.resy.count.min.",
"examples": [
100
]
},
"resy_count_max": {
"type": "integer",
"description": "Who serves or stocks it (F5): Resy rating count at most. Qloo: filter.external.resy.count.max.",
"examples": [
10000
]
},
"resy_party_min": {
"type": "integer",
"description": "Who serves or stocks it (F5): Resy party size at least. Qloo: filter.external.resy.party_size.min.",
"examples": [
2
]
},
"resy_party_max": {
"type": "integer",
"description": "Who serves or stocks it (F5): Resy party size at most. Qloo: filter.external.resy.party_size.max.",
"examples": [
8
]
},
"external": {
"type": "string",
"description": "Who serves or stocks it (F5): Listed on these (resy, michelin, tablet). Qloo: filter.external.exists. comma-separated, of: resy, michelin, tablet",
"examples": [
"resy"
]
},
"external_operator": {
"type": "string",
"enum": [
"union",
"intersection"
],
"description": "Who serves or stocks it (F5): Any (union) or all (intersection) of those. Qloo: operator.filter.external.exists.",
"examples": [
"union"
]
},
"product_kind": {
"type": "string",
"enum": [
"film",
"tv",
"book",
"person",
"artist",
"brand",
"podcast",
"game",
"place",
"destination"
],
"description": "Media and people products (F6): Product kind: what the comparables are. Qloo: filter.type.",
"examples": [
"film"
]
},
"content_rating": {
"type": "string",
"description": "Media and people products (F6): Film/TV content rating(s), MPAA. Qloo: filter.content_rating.",
"examples": [
"PG-13"
]
},
"year_min": {
"type": "integer",
"description": "Media and people products (F6): Released from this year (film/TV; books: publication year). Qloo: filter.release_year.min.",
"examples": [
2015
]
},
"year_max": {
"type": "integer",
"description": "Media and people products (F6): Released up to this year (film/TV; books: publication year). Qloo: filter.release_year.max.",
"examples": [
2024
]
},
"release_country": {
"type": "string",
"description": "Media and people products (F6): Film/TV released in these countries. Qloo: filter.release_country.",
"examples": [
"United States"
]
},
"release_country_operator": {
"type": "string",
"enum": [
"union",
"intersection"
],
"description": "Media and people products (F6): Any (union) or all (intersection) of those. Qloo: operator.filter.release_country.",
"examples": [
"union"
]
},
"rating_min": {
"type": "number",
"description": "Media and people products (F6): Film/TV Qloo rating at least (0-5). Qloo: filter.rating.min.",
"examples": [
3.5
]
},
"rating_max": {
"type": "number",
"description": "Media and people products (F6): Film/TV Qloo rating at most (0-5). Qloo: filter.rating.max.",
"examples": [
5
]
},
"finale_year_min": {
"type": "integer",
"description": "Media and people products (F6): TV: final season from this year. Qloo: filter.finale_year.min.",
"examples": [
2018
]
},
"finale_year_max": {
"type": "integer",
"description": "Media and people products (F6): TV: final season up to this year. Qloo: filter.finale_year.max.",
"examples": [
2024
]
},
"latest_year_min": {
"type": "integer",
"description": "Media and people products (F6): TV: released or updated from this year. Qloo: filter.latest_known_year.min.",
"examples": [
2020
]
},
"latest_year_max": {
"type": "integer",
"description": "Media and people products (F6): TV: released or updated up to this year. Qloo: filter.latest_known_year.max.",
"examples": [
2025
]
},
"born_min": {
"type": "string",
"description": "Media and people products (F6): Person: born on or after (YYYY-MM-DD). Qloo: filter.date_of_birth.min.",
"examples": [
"1960-01-01"
]
},
"born_max": {
"type": "string",
"description": "Media and people products (F6): Person: born on or before (YYYY-MM-DD). Qloo: filter.date_of_birth.max.",
"examples": [
"1990-12-31"
]
},
"died_min": {
"type": "string",
"description": "Media and people products (F6): Person: died on or after (YYYY-MM-DD). Qloo: filter.date_of_death.min.",
"examples": [
"2000-01-01"
]
},
"died_max": {
"type": "string",
"description": "Media and people products (F6): Person: died on or before (YYYY-MM-DD). Qloo: filter.date_of_death.max.",
"examples": [
"2020-12-31"
]
},
"person_gender": {
"type": "string",
"enum": [
"male",
"female"
],
"description": "Media and people products (F6): Person: gender. Qloo: filter.gender.",
"examples": [
"female"
]
},
"lookup": {
"type": "string",
"description": "Look up exact things (F7): Look up exact things: a name to find (Search Entities). Qloo: query.",
"examples": [
"Austin"
]
},
"lookup_types": {
"type": "string",
"description": "Look up exact things (F7): What kinds to search. Qloo: types. comma-separated, of: urn:entity:actor, urn:entity:album, urn:entity:artist, urn:entity:author, urn:entity:book, urn:entity:brand, urn:entity:destination, urn:entity:director, urn:entity:locality, urn:entity:movie, urn:entity:person, urn:entity:place, urn:entity:podcast, urn:entity:tv_show, urn:entity:videogame",
"examples": [
"urn:entity:locality"
]
},
"lookup_near": {
"type": "string",
"description": "Look up exact things (F7): Search near: lat,lon or WKT. Qloo: filter.location.",
"examples": [
"30.2672,-97.7431"
]
},
"lookup_radius": {
"type": "number",
"description": "Look up exact things (F7): Search radius in miles (0-100). Qloo: filter.radius.",
"examples": [
10
]
},
"lookup_sort": {
"type": "string",
"enum": [
"match",
"distance",
"popularity"
],
"description": "Look up exact things (F7): Order the search by. Qloo: sort_by.",
"examples": [
"match"
]
},
"entity_id": {
"type": "string",
"description": "Look up exact things (F7): Look up exact things: paste a Qloo entity id (Search Entities by ID). Qloo: entity_ids.",
"examples": [
"B2A5BF4D-6D9A-4A8B-9E50-1A2B3C4D5E6F"
]
},
"qloo": {
"type": "object",
"additionalProperties": true,
"description": "Anything else in the guide (F8): Any other documented parameter for the call's filter.type, by its Qloo name. Qloo: *.",
"examples": [
{
"bias.trends": "high"
}
]
},
"qloo_calls": {
"type": "object",
"additionalProperties": true,
"description": "Anything else in the guide (F8): Calls to Qloo's other endpoints by path, each with its own documented parameters. Qloo: *.",
"examples": [
{
"/v2/tags": {
"filter.query": "trail running",
"feature.semantic_search": "true"
}
}
]
}
},
"required": [
"idea"
],
"additionalProperties": false
}🟢knos_crossings
Every crossing this server ran, newest first: id, paper or idea, verdict, report hash.
입력 스키마
{
"type": "object",
"properties": {},
"additionalProperties": false
}🟢knos_milestones
Lists every commitment on this server with its held order and its status.
입력 스키마
{
"type": "object",
"properties": {},
"additionalProperties": false
}🟢knos_tasks
Open milestones and tasks a person or agent can work on; each is checked by its referee and paid on devnet (test money).
입력 스키마
{
"type": "object",
"properties": {},
"additionalProperties": false
}🟢knos_memory_search(q)
FTS5 search (multilingual) over the agents' memory and the Knos Record: papers, crossings, decisions, events.
입력 스키마
{
"type": "object",
"properties": {
"q": {
"type": "string"
}
},
"required": [
"q"
],
"additionalProperties": false
}🟢knos_memory_recall(ref, idea)
Sibyl, the crossing agent's working memory: the last crossing of a paper or idea (product phrase, verdict, report).
입력 스키마
{
"type": "object",
"properties": {
"ref": {
"type": "string"
},
"idea": {
"type": "string"
}
},
"additionalProperties": false
}🔴knos_sign_in(label)
Returns a guest session token that the tools moving devnet test money accept; ask your human first.
입력 스키마
{
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "a note on who opened it; never shown (the session shows as Guest and 4 characters of its id)"
}
},
"required": [
"label"
],
"additionalProperties": false
}🔴knos_preorder(report, units, session)
Prepares a pre-order of an OPEN report and returns the page where your human's passkey approves it with devnet test money; ask your human first.
입력 스키마
{
"type": "object",
"properties": {
"report": {
"type": "string"
},
"units": {
"type": "integer"
},
"session": {
"type": "string"
}
},
"required": [
"report",
"units"
],
"additionalProperties": false
}🔴knos_evidence(commitment, evidence_url, session)
Posts a milestone's public evidence page, whose verified evidence releases the held devnet test money to the maker; ask your human first.
입력 스키마
{
"type": "object",
"properties": {
"commitment": {
"type": "string"
},
"evidence_url": {
"type": "string"
},
"session": {
"type": "string"
}
},
"required": [
"commitment",
"evidence_url"
],
"additionalProperties": false
}🔴knos_task_submit(round, name, code, wallet, session)
Submits a milestone's proof file to its referee and returns the verdict, with devnet test money paid when the proof meets the target; ask your human first.
입력 스키마
{
"type": "object",
"properties": {
"round": {
"type": "string"
},
"name": {
"type": "string"
},
"code": {
"type": "string"
},
"wallet": {
"type": "string"
},
"session": {
"type": "string"
}
},
"required": [
"round",
"code"
],
"additionalProperties": false
}🟢knos_templates
Returns the brief templates Knos offers, from AI model evals to regulatory milestones taken from OpenRegulatory's open templates.
입력 스키마
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}🟢knos_projects(id, take)
The newest projects (take, default 10) as summaries: each milestone's state and held units. With id: one project in full, with its milestones (tranches), held orders, AMC commitments, attempts and where the work can be bought.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"take": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [],
"additionalProperties": false
}🔴knos_project_open(template, title, regulatory, session)
Opens a project whose milestones each hold devnet test money until a result and an independent check arrive; ask your human first.
입력 스키마
{
"type": "object",
"properties": {
"template": {
"type": "string"
},
"title": {
"type": "string"
},
"regulatory": {
"type": "array",
"items": {
"type": "string"
}
},
"session": {
"type": "string"
}
},
"required": [
"template",
"title"
],
"additionalProperties": false
}🔴knos_project_claim(project, milestone, wallet, session)
Claims a milestone as its maker and binds the wallet it pays in devnet test money; ask your human first.
입력 스키마
{
"type": "object",
"properties": {
"project": {
"type": "string"
},
"milestone": {
"type": "string"
},
"wallet": {
"type": "string"
},
"session": {
"type": "string"
}
},
"required": [
"project",
"milestone"
],
"additionalProperties": false
}🔴knos_project_post(project, milestone, attempt, url, role, ...)
Posts a result or a check page for a milestone, and the referee panel releases its devnet test money when both are in; ask your human first.
입력 스키마
{
"type": "object",
"properties": {
"project": {
"type": "string"
},
"milestone": {
"type": "string"
},
"attempt": {
"type": "string"
},
"url": {
"type": "string"
},
"role": {
"type": "string"
},
"session": {
"type": "string"
}
},
"required": [
"project",
"milestone",
"attempt",
"url",
"role"
],
"additionalProperties": false
}🔴knos_milestone_submit(project, milestone, code, wallet, session, ...)
Sends a milestone's proof file to its referee and releases its devnet test money to you when the verdict meets the target; ask your human first.
입력 스키마
{
"type": "object",
"properties": {
"project": {
"type": "string"
},
"milestone": {
"type": "string"
},
"code": {
"type": "string",
"description": "the whole train.py"
},
"wallet": {
"type": "string"
},
"session": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"observation",
"oru"
],
"description": "a lab's proof instead of code: a FHIR Observation or an HL7 ORU message, checked by the rules referee IRIS runs too (the decision only; nothing moves)"
},
"proof": {
"description": "the Observation (an object) or the ORU message (a string)"
},
"brief": {
"type": "object",
"description": "the locked brief the lab proof answers"
}
},
"required": [],
"additionalProperties": false
}🟢knos_openapi
The same API as REST: /openapi.json.
입력 스키마
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}🟢knos_ready(brief)
Checks a brief before any money locks and returns Ready, or the missing fields with a rewrite template, sending nothing.
입력 스키마
{
"type": "object",
"properties": {
"brief": {
"type": "object"
}
},
"required": [
"brief"
],
"additionalProperties": false
}🟢knos_usage(record)
Returns how many times each Knos tool was called over MCP since this server started.
입력 스키마
{
"type": "object",
"properties": {
"record": {
"type": "object",
"description": "a goal's measured token use (scripts/goal_usage.py); the operator only"
}
},
"required": [],
"additionalProperties": false
}🟢knos_milestone_prompt(project, milestone)
Returns the locked intent of a milestone you work on, with its criteria hash and the token budget for answering it.
입력 스키마
{
"type": "object",
"properties": {
"project": {
"type": "string"
},
"milestone": {
"type": "string"
}
},
"required": [
"project",
"milestone"
],
"additionalProperties": false
}🟢knos_near_swarm_job(id)
Reads one job from the jobs contract on NEAR testnet (jobs.knos-swarm-1105.testnet): its bid, the locked test's hash, which agent took it, what each submitted, and who was paid. Read only.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 64,
"description": "the job id, such as job-1105164458"
}
},
"required": [
"id"
],
"additionalProperties": false
}🟢knos_iris_check_proof(brief, kind, proof)
Applies the rules referee IRIS runs to one proof (a CI check run, a FHIR Observation or an HL7 ORU message) against a brief's milestones, and returns met or not met per milestone with the reason. Nothing is signed and no money moves.
입력 스키마
{
"type": "object",
"properties": {
"brief": {
"type": "object",
"description": "the brief: {milestones: [{key, name, target, verifier}]}"
},
"kind": {
"type": "string",
"enum": [
"checkrun",
"observation",
"oru"
],
"description": "what the proof is"
},
"proof": {
"type": [
"object",
"string"
],
"description": "the proof itself"
}
},
"required": [
"brief",
"kind",
"proof"
],
"additionalProperties": false
}🔴knos_near_run_job
Funds one job on NEAR testnet from Knos's capped test account (a bid of 1000 test units), lets two agents take it and submit, and has the checker pay only the agent whose output passes the locked test. Capped: one run at a time, 20 a day; past a cap it returns the last run as a replay.
입력 스키마
{
"type": "object",
"properties": {},
"additionalProperties": false
}🟢knos_near_job_status(run)
The step a run of knos_near_run_job is on, and at the end who was paid and every testnet transaction.
입력 스키마
{
"type": "object",
"properties": {
"run": {
"type": "string",
"maxLength": 24,
"description": "the run id"
}
},
"required": [
"run"
],
"additionalProperties": false
}커뮤니티
증거