Servidor MCP

ranked

ng.ranked/ranked

Qué hace este MCP

Searches and compares Nigerian businesses and products, provides city and category rankings, and checks regulator-register listings and Nigeria-specific payment usability.

compare_places
Two Ranked places side by side, on the published score
Two business listings side by side, by slug (the tail of https://ranked.ng/place/<slug>). A record, not a recommendation: the answer carries each side's displayed rank, Ranked score and six-dimension breakdown on their SHARED published category-city facet, Google rating/review count as source data, the evidence-only verified tier, distance_km between the two listings, and dimension_leads: per dimension which side scores higher on Ranked's published breakdown, with a gap under tie_band_points (5) reported as "even". It never picks a side and never infers rank from score. same_facet=false when the two are not on one category and city (scores are then not comparable and dimension_leads is null); an unpublished facet answers { published: false, reason }. The cite url is the pair page https://ranked.ng/vs/<lo>/<hi> when both sides sit inside its rendered window, else the ranking page.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['a', 'b'], 'properties': {'a': {'type': 'string', 'description': "first place slug, e.g. 'eko-hotels-and-suites-a1b2c3'"}, 'b': {'type': 'string', 'description': 'second place slug'}}, 'additionalProperties': False}
ranked_by_regulator
List a regulator's register, as accessed
List the entries on a Nigerian regulator's register (CBN, SEC, NAICOM, NCC, PenCom) as accessed on the snapshot date, optionally filtered by licence-class text, in the register's own order (the regulator's order, not a ranking). Source is the regulator's own publication; the licence class is as the regulator states it. Each row carries the register's statement, hub_url, feed_url and place_url where Ranked has a matching listing. A register row is what the regulator's register listed on the access date. It is not a licence finding by Ranked, registers lag revocations, and absence from Ranked's copy is not proof that a name is unlicensed.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['regulator'], 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0}, 'category': {'type': 'string', 'description': "filter on licence class / scope text, e.g. 'microfinance', 'broker', 'ISP', 'PFA'"}, 'regulator': {'enum': ['CBN', 'SEC', 'NAICOM', 'NCC', 'PENCOM'], 'type': 'string'}}, 'additionalProperties': False}
ranked_can_nigerian_pay
Can someone in Nigeria actually pay for this product?
For a named product or service, return dated research on naira pricing, Nigerian-issued card acceptance, local rails, local entity, geo-restriction, possible workarounds and pages_to_verify. These are snapshot observations, not a current payment guarantee: availability and limits depend on the product, issuer and account. Missing evidence is returned as 'unknown'.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'product or service name, or its domain'}}, 'additionalProperties': False}
ranked_check_licence
Does this name appear on a Nigerian regulator's register?
Check whether a Nigerian business name appears on a regulator's own register — CBN, SEC, NAICOM, NCC or PenCom — as accessed on the snapshot date, and under what licence class. Exact normalised-name match first, then partial. Each match carries the register's statement ("Appears on the <REG> register as accessed on <date>..."), the hub_url, the JSON feed_url, and place_url when Ranked has a matching indexable listing. A register row is what the regulator's register listed on the access date. It is not a licence finding by Ranked, registers lag revocations, and absence from Ranked's copy is not proof that a name is unlicensed. Ranked never says "licensed" in its own voice.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'business name as on the offer, policy or app'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1}, 'regulator': {'enum': ['CBN', 'SEC', 'NAICOM', 'NCC', 'PENCOM', 'any'], 'type': 'string', 'default': 'any'}}, 'additionalProperties': False}
ranked_compare
Compare products on Nigeria-usability
Compare 2-5 named products or services on Nigeria-usability: naira pricing, card acceptance, local entity, geo-restriction. Rows are returned in the order given — Ranked does not rank them here. Ranked Technologies operates some listed products; those carry operated_by_ranked=true, are returned in a separate unranked block, and are never ordered above others (Rule 1). Evidence tier is provenance, not quality.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['names'], 'properties': {'names': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 5, 'minItems': 2}}, 'additionalProperties': False}
ranked_find_business
Find a Nigerian business, website or app in Ranked's file-backed dataset
Search Ranked's file-backed dataset of Nigerian-relevant businesses, institutions, websites and apps (6519 entries: 3860 on a regulator register, 1290 with domain/app-listing evidence, 1369 unverified candidates). Categories are source/research labels, not live ranking eligibility. Results carry source and snapshot date, plus source and canonical URLs where available; register-backed results carry the register's entry and access date. For live rankings and place pages use ranked_rankings / ranked_place. Ranked Technologies operates some listed products; those carry operated_by_ranked=true, are returned in a separate unranked block, and are never ordered above others (Rule 1). Evidence tier is provenance, not quality.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 15, 'maximum': 50, 'minimum': 1}, 'query': {'type': 'string', 'description': 'name, domain, category or licence type'}}, 'additionalProperties': False}
ranked_hubs
Public hub URLs on ranked.ng, with coverage counts
The list pages an assistant can cite, with counts: kind="category" → https://ranked.ng/<category> hubs with the number of cities that have a published ranking with exact-category matches; kind="city" → https://ranked.ng/city/<slug> hubs with matching published categories; kind="state" → https://ranked.ng/state/<slug> hubs (only states with at least 25 operational listings); kind="data" → the regulator-register hubs, the operator-listed EV charging directory, their JSON feeds and the open-data index (file-backed, no database needed). These are coverage counts, not a claim that search engines index every URL.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['kind'], 'properties': {'kind': {'enum': ['category', 'city', 'state', 'data'], 'type': 'string'}, 'limit': {'type': 'integer', 'default': 100, 'maximum': 500, 'minimum': 1}}, 'additionalProperties': False}
ranked_place
One Ranked place page, with its rank and register matches
One business listing from the production database, by slug (the tail of https://ranked.ng/place/<slug>) or by name + city. Returns name, category, city, state, address, phone (business phones are public), website, Google rating/review count, the evidence-only verified tier, its rank on its primary PUBLISHED facet if any, regulator-register matches (with 'as accessed on' provenance), the canonical url, data_as_of (Google listing fetch date when supported; otherwise null), profile_evidence separating listing fetches, review publication and analysis dates, source_facts with dated source citations, and observations: the dated record of what changed on the listing (name, address, phone, website, business status, opening hours), newest first, each with the source that reported it. Places that are not OPERATIONAL are excluded unless includeClosed=true.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'city': {'type': 'string', 'description': 'city slug or name (used with name)'}, 'name': {'type': 'string', 'description': 'business name (used with city when slug is absent)'}, 'slug': {'type': 'string', 'description': "place slug, e.g. 'abbey-mortgage-bank-plc-k5mjcu'"}, 'includeClosed': {'type': 'boolean', 'default': False}}, 'additionalProperties': False}
ranked_rankings
Ranked's live ranking for a category in a city
Ranked's ORDERED list for a category in a Nigerian city — the one fact nobody else has — straight from the production database, top 25 at most. Category and city accept a slug ("hotels", "lagos") or a name ("Hotels", "Port Harcourt"). Served ONLY when the base page is published; otherwise { published: false, reason }. Each entry carries rank, url (https://ranked.ng/place/<slug>), Ranked's score and breakdown, Google rating/review count as provenance-carrying source data, an evidence-only verified tier, and data_as_of. The answer carries page_url, feed_url, last_published_at, methodology (https://ranked.ng/how-we-rank) and accessed_on = today. Paid placement never affects position. No product operated by Ranked is ever ranked.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['category', 'city'], 'properties': {'city': {'type': 'string', 'description': "city slug or name, e.g. 'lagos' or 'Port Harcourt'"}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 25, 'minimum': 1}, 'category': {'type': 'string', 'description': "category slug or name, e.g. 'hotels' or 'Microfinance Banks'"}}, 'additionalProperties': False}
ranked_stats
What Ranked's MCP holds, and its rules
Counts of what this server holds — file-backed dataset by evidence tier, kind and regulator with each register's access date; whether the live database is configured — plus the provenance rules. Use to explain provenance to a user.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Añadido
ranked_hubs
17 de September de 2026 a las 12:54
Añadido
compare_places
17 de September de 2026 a las 12:54
Añadido
ranked_place
17 de September de 2026 a las 12:54
Añadido
ranked_rankings
17 de September de 2026 a las 12:54
Añadido
ranked_stats
17 de September de 2026 a las 12:54
Añadido
ranked_by_regulator
17 de September de 2026 a las 12:54
Añadido
ranked_compare
17 de September de 2026 a las 12:54
Añadido
ranked_check_licence
17 de September de 2026 a las 12:54
Añadido
ranked_can_nigerian_pay
17 de September de 2026 a las 12:54
Añadido
ranked_find_business
17 de September de 2026 a las 12:54