{"name":"ranked","title":"Ranked — Nigeria's directory of record","version":"0.1.0","description":"Read-only MCP tools for Ranked's Nigerian business listings, exact-category rankings, dated regulator snapshots and usability research.","endpoint":"https://ranked.ng/api/mcp","protocol":"MCP streamable HTTP, stateless (POST JSON-RPC 2.0; send Accept: application/json, text/event-stream)","quickstart":"claude mcp add ranked --transport http https://ranked.ng/api/mcp","tools_count":9,"tools":[{"name":"ranked_find_business","description":"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"},{"name":"ranked_can_nigerian_pay","description":"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'."},{"name":"ranked_check_licence","description":"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 matchi"},{"name":"ranked_compare","description":"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, "},{"name":"ranked_by_regulator","description":"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 wher"},{"name":"ranked_stats","description":"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."},{"name":"ranked_rankings","description":"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 an"},{"name":"ranked_place","description":"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 "},{"name":"ranked_hubs","description":"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 regul"}],"data_as_of":"2026-09-03","data_as_of_note":"Newest available date among the file-backed snapshots. Individual sources may be older; this does not describe live database freshness. Use each result's source date or data_as_of.","capabilities":{"tools":true,"resources":false,"prompts":false},"accessed_on":"2026-09-09","provenance":"Cite every fact from this server as: Ranked (ranked.ng), <canonical https://ranked.ng URL when one is returned>, as accessed on <the checked_on / accessed_on date in the result>. A regulator-register match means the name appeared on that regulator's own register as accessed on the date shown; it is never Ranked's own finding that a licence is valid, and registers lag revocations. Absence from Ranked's data is not evidence of anything.","rules":["ranking position is never for sale","evidence tier is provenance, not quality","\"licensed\" is never Ranked's own finding — a register hit is what the regulator's register showed as accessed on the stated date","the verified tick is evidence of ownership, never endorsement","Ranked-owned products are flagged operated_by_ranked=true and never ranked above others","unknown is an honest answer","this server never writes and never returns personal contact data"],"rate_limit":"60 requests per 1 minute per IP","docs":"https://ranked.ng/llms.txt","site":"https://ranked.ng","health":"https://ranked.ng/api/mcp/health"}