Read-only tools over Ranked, a Nigerian business directory with dated regulator register snapshots
ng.ranked/ranked — MCP Server
This MCP server provides read-only tools over Ranked, a Nigerian business directory that includes dated regulator register snapshots. It exposes 9 tools, and is described with the name “ng.ranked/ranked” and the slug “ng-ranked-ranked,” indicating focused functionality around accessing directory and snapshot data.
🛠️ Key Features
Read-only access to Ranked
Works with a Nigerian business directory
Utilizes dated regulator register snapshots
Provides 9 tools
🚀 Use Cases
Query information from the Ranked Nigerian business directory
Access regulator register snapshot data associated with dates
⚡ Developer Benefits
Clear integration surface with read-only tool behavior
Fixed tool set (9 tools) for directory/snapshot retrieval
Captured live from the server via tools/list.
ranked_find_business
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.
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'.
Parameters1
name
string
required
product or service name, or its domain
Raw schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "product or service name, or its domain"
}
},
"required": [
"name"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}
ranked_check_licence
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.
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.
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.
Parameters4
regulator
string
required
category
string
optional
filter on licence class / scope text, e.g. 'microfinance', 'broker', 'ISP', 'PFA'
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.
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.
Parameters3
category
string
required
category slug or name, e.g. 'hotels' or 'Microfinance Banks'
city
string
required
city slug or name, e.g. 'lagos' or 'Port Harcourt'
limit
integer
optional
Raw schema
{
"type": "object",
"properties": {
"category": {
"type": "string",
"description": "category slug or name, e.g. 'hotels' or 'Microfinance Banks'"
},
"city": {
"type": "string",
"description": "city slug or name, e.g. 'lagos' or 'Port Harcourt'"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 10
}
},
"required": [
"category",
"city"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}
ranked_place
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.
Parameters4
slug
string
optional
place slug, e.g. 'abbey-mortgage-bank-plc-k5mjcu'
name
string
optional
business name (used with city when slug is absent)
city
string
optional
city slug or name (used with name)
includeClosed
boolean
optional
Raw schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "place slug, e.g. 'abbey-mortgage-bank-plc-k5mjcu'"
},
"name": {
"type": "string",
"description": "business name (used with city when slug is absent)"
},
"city": {
"type": "string",
"description": "city slug or name (used with name)"
},
"includeClosed": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}
ranked_hubs
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.