Servers Playground How we check Add a server Log in

NicheDB

Working · 1.6 s

dev.nichedb/nichedbv0.1.0 Domain verified

Sources in, feeds out: an open, ever-growing database of real-time public data, enriched.

Data & Databases

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://nichedb.dev/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

add_source

Add a source: an adapter with a config, fetched on a schedule (needs a key; admins and Pro). Call list_adapters first for the fields.

adapterstring, required

Adapter name, e.g. github-releases

namestring

Display name

configobject

Adapter config fields

collectionstring

Collection slug; defaults to the adapter's

cadence_minutesinteger

5 to 1440

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

NicheDB MCP server | mcptry

Tools (30)

add_source

Add a source: an adapter with a config, fetched on a schedule (needs a key; admins and Pro). Call list_adapters first for the fields.

Argument	Type	Description
name	string	Display name
config	object	Adapter config fields
adapter*	string	Adapter name, e.g. github-releases
collection	string	Collection slug; defaults to the adapter's
cadence_minutes	integer	5 to 1440

Input schema (JSON)

{
  "type": "object",
  "required": [
    "adapter"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Display name"
    },
    "config": {
      "type": "object",
      "description": "Adapter config fields"
    },
    "adapter": {
      "type": "string",
      "description": "Adapter name, e.g. github-releases"
    },
    "collection": {
      "type": "string",
      "description": "Collection slug; defaults to the adapter's"
    },
    "cadence_minutes": {
      "type": "integer",
      "description": "5 to 1440"
    }
  }
}

business_standing

Is a business on anybody's list? Give its `name`, and any of `domain`, `state` (two letters), `number` (state entity number) and `ein`. Answers with `standing` (flagged, incomplete or clear; clear only when every list was checked and found nothing), the `findings` behind it, and each section: US Treasury OFAC sanctions (SDN and consolidated, aliases included), GLEIF LEI records, SEC EDGAR filers, state registry status (OpenCorporates) and SAM.gov exclusions when keyed, and the domain over RDAP plus Spamhaus/URIBL/SURBL/Safe Browsing when the operator enabled them. A name match is not an identity: confirm against address and identifiers.

Argument	Type	Description
ein	string	US EIN, kept to identify it, never checked (optional)
name	string	Company name, e.g. Profullstack, Inc.
state	string	Two-letter US state it is registered in (optional)
domain	string	Its website or mail domain (optional)
number	string	State entity number, e.g. 4218574 (optional)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "ein": {
      "type": "string",
      "description": "US EIN, kept to identify it, never checked (optional)"
    },
    "name": {
      "type": "string",
      "description": "Company name, e.g. Profullstack, Inc."
    },
    "state": {
      "type": "string",
      "description": "Two-letter US state it is registered in (optional)"
    },
    "domain": {
      "type": "string",
      "description": "Its website or mail domain (optional)"
    },
    "number": {
      "type": "string",
      "description": "State entity number, e.g. 4218574 (optional)"
    }
  }
}

check_domain

Is a domain name registered? Asks each registry over RDAP. Give `name` as a full name (foo.watches), or a bare word with `tlds` (foo + com,dev,io), or several names comma separated. Each answer is registered (with registrar and expiry), not_registered, or unknown. not_registered means the registry holds no registration; the name may still be reserved or premium, so it is not a promise that it is for sale. unknown (no RDAP server, a timeout, a 429) is never a yes. Each answer carries the cheapest known USD price for its ending.

Argument	Type	Description
name*	string	foo.watches, or foo, or a.com,b.dev
tlds	string	Endings to try a bare word under, comma separated (optional)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "foo.watches, or foo, or a.com,b.dev"
    },
    "tlds": {
      "type": "string",
      "description": "Endings to try a bare word under, comma separated (optional)"
    }
  }
}

claim_profile

Claim a profile as the key owner (needs a key). Proven when the key owner’s email is one the profile lists, or when the person’s site or show page links back to the profile’s nichedb page. An admin may claim on behalf of an email.

Argument	Type	Description
ref*	string	Profile id, slug-id or handle
email	string	Admins only: claim it for this email

Input schema (JSON)

{
  "type": "object",
  "required": [
    "ref"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "Profile id, slug-id or handle"
    },
    "email": {
      "type": "string",
      "description": "Admins only: claim it for this email"
    }
  }
}

create_feed

Save a query as a feed (needs a key). Sources, kinds and tags narrow; q is a text match; upcoming keeps only future-dated items.

Argument	Type	Description
q	string	Text match
lat	number	Query center latitude; requires long
bbox	string	west,south,east,north; west > east crosses the antimeridian
long	number	Query center longitude; requires lat
name*	string	Feed name
sort	string
tags	array	Tags, any match
unit	string	Default km
kinds	array	Item kinds
public	boolean	Default true
radius	number	Default 10; maximum 1000 km

feed_items

What a feed selects, newest first. Page with before_id.

Argument	Type	Description
lat	number	Query center latitude; requires long
bbox	string	west,south,east,north; west > east crosses the antimeridian
feed*	string	Feed slug
long	number	Query center longitude; requires lat
sort	string
unit	string	Default km
limit	integer	Default 30, max 200
offset	integer	Distance pagination offset
radius	number	Default 10; maximum 1000 km
before_id	integer	Keyset cursor; cannot combine with distance sorting

Input schema (JSON)

{
  "type": "object",
  "required": [
    "feed"
  ],
  "properties": {
    "lat": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Query center latitude; requires long"
    },
    "bbox": {
      "type": "string",
      "description": "west,south,east,north; west > east crosses the antimeridian"
    },
    "feed": {
      "type": "string",
      "description": "Feed slug"
    },
    "long": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Query center longitude; requires lat"
    },
    "sort": {
      "enum": [
        "id",
        "published",
        "updated",
        "distance"
      ],
      "type": "string"
    },
    "unit": {
      "enum": [
        "km",
        "mi"
      ],
      "type": "string",
      "description": "Default km"
    },
    "limit": {
      "type": "integer",
      "description": "Default 30, max 200"
    },
    "offset": {
      "type": "integer",
      "description": "Distance pagination offset"
    },
    "radius": {
      "type": "number",
      "description": "Default 10; maximum 1000 km",
      "exclusiveMinimum": 0
    },
    "before_id": {
      "type": "integer",
      "description": "Keyset cursor; cannot combine with distance sorting"
    }
  }
}

find_profile_by_linkedin

The public profile a LinkedIn profile or company URL belongs to (linkedin.com/in/… or /company/…), or null. LinkedIn only: profiles are never looked up by email.

Argument	Type	Description
url*	string	A LinkedIn URL, e.g. https://www.linkedin.com/in/ada

Input schema (JSON)

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "A LinkedIn URL, e.g. https://www.linkedin.com/in/ada"
    }
  }
}

follow_feed

Follow a feed as the key owner (needs a key). Channels: webpush, email, webhook.

Argument	Type	Description
feed*	string	Feed slug
channels	array	Default webpush,email
webhook_url	string	For the webhook channel
webhook_secret	string	Shared secret the receiver verifies with

Input schema (JSON)

{
  "type": "object",
  "required": [
    "feed"
  ],
  "properties": {
    "feed": {
      "type": "string",
      "description": "Feed slug"
    },
    "channels": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Default webpush,email"
    },
    "webhook_url": {
      "type": "string",
      "description": "For the webhook channel"
    },
    "webhook_secret": {
      "type": "string",
      "description": "Shared secret the receiver verifies with"
    }
  }
}

get_item

One item with its full adapter payload.

Argument	Type	Description
id*	integer	Item id

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Item id"
    }
  }
}

get_profile

One person by id, `<slug>-<id>` or handle: the parsed view and the OpenProfile.md as served.

Argument	Type	Description
ref*	string	Profile id, slug-id or handle

Input schema (JSON)

{
  "type": "object",
  "required": [
    "ref"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "Profile id, slug-id or handle"
    }
  }
}

get_tld

One top-level domain: type, registry, RDAP server, when it entered or left the root, every registrar price (register, renew, transfer, restore, promotions, privacy, restrictions) and its change history.

Argument	Type	Description
tld*	string	The label, with or without the dot; Unicode or xn-- both work

Input schema (JSON)

{
  "type": "object",
  "required": [
    "tld"
  ],
  "properties": {
    "tld": {
      "type": "string",
      "description": "The label, with or without the dot; Unicode or xn-- both work"
    }
  }
}

list_adapters

Every adapter this deployment can run, with the config fields each takes. Use before add_source.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_collections

The collections (niches) with their source, feed and item counts.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_enrichers

Every enricher (YouTube videos, Wikipedia, repo stats, downloads, company profiles, TL;DRs) and which collections turn it on by default. Items carry their results under `enrichment`.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_feeds

Public feeds, most followed first. Optionally one collection.

Argument	Type	Description
collection	string	Collection slug

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "collection": {
      "type": "string",
      "description": "Collection slug"
    }
  }
}

list_sources

Sources with status, last run and item counts. Optionally one collection.

Argument	Type	Description
collection	string	Collection slug, e.g. games

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "collection": {
      "type": "string",
      "description": "Collection slug, e.g. games"
    }
  }
}

match_items

Which title, channel or fixture is this name? Give a file name, a release name or a playlist entry ("Top.Gun.Maverick.2022.1080p.mkv", "US: ESPN2 HD"); it is cleaned (year, season and episode, quality tags, playlist decorations) and matched by similarity. A matchup ("NFL: Chiefs vs Bills", "Lakers @ Celtics", "Rangers at Celtic 19:45") is answered by the fixture whose two teams those are, kicking off between 36 hours ago and 7 days ahead unless date narrows it. Each result carries a score in 0..1. Use screen for films and TV, channels for television channels, sports for fixtures.

Argument	Type	Description
q*	string	The name as written
lat	number	Query center latitude; requires long
bbox	string	west,south,east,north; west > east crosses the antimeridian
date	string	A day (YYYY-MM-DD) to look for a fixture on, plus a day either side
kind	string	Item kind: title, channel, fixture
long	number	Query center longitude; requires lat
sort	string
unit	string	Default km
year

population

Population and demography, drilled down from the world to the ZIP code. Give a `key` (us, us-ca, us-ca-los-angeles, gb, gb-england-london), a US `zip`, or a place name in `q`; no argument is the world. Answers with the area (population, year, measures: age, income, home value, rent, poverty, education, unemployment, race and Hispanic origin for the US; growth, age structure, births, deaths, fertility, life expectancy, migration, GDP per head and Gini for countries), how many areas of each level it contains, and the largest of its children at `level` (country, state, city or zip). Sources: World Bank, US Census ACS 5-year, GeoNames.

Argument	Type	Description
q	string	A place name to look up, e.g. Springfield (optional)
key	string	Area key, e.g. us, us-ca, us-ca-los-angeles, us-90210, de (optional)
zip	string	A US ZIP code (optional)
level	string	Which children to list: country, state, city or zip (optional)
limit	integer	Children to list, default 20, max 500
offset	integer	Skip this many children, for paging

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "A place name to look up, e.g. Springfield (optional)"
    },
    "key": {
      "type": "string",
      "description": "Area key, e.g. us, us-ca, us-ca-los-angeles, us-90210, de (optional)"
    },
    "zip": {
      "type": "string",
      "description": "A US ZIP code (optional)"
    },
    "level": {
      "type": "string",
      "description": "Which children to list: country, state, city or zip (optional)"
    },
    "limit": {
      "type": "integer",
      "description": "Children to list, default 20, max 500"
    },
    "offset": {
      "type": "integer",
      "description": "Skip this many children, for paging"
    }
  }
}

recent_items

Newest items, optionally narrowed to a collection, source or kind.

Argument	Type	Description
lat	number	Query center latitude; requires long
bbox	string	west,south,east,north; west > east crosses the antimeridian
kind	string	Item kind
long	number	Query center longitude; requires lat
sort	string
unit	string	Default km
limit	integer	Default 30, max 200
offset	integer	Distance pagination offset
radius	number	Default 10; maximum 1000 km
source	string	Source slug
before_id	integer	Keyset cursor; cannot combine with distance sorting

reputation_lookup

Is an IP address or a domain on a blocklist? Give `indicator` (an IPv4/IPv6 address or a domain; a URL is reduced to its host). Answers `listed`, a rough 0-100 `score` with the `reasons` behind it, the nichedb /traffic record (addresses our own servers banned and a person approved), the abuse.ch indicators (ThreatFox, URLhaus, Feodo Tracker; a domain is checked with its parent domains), the SURBL standing of a watched domain, and live DNS blocklists in `dnsbl` (an address: Spamhaus ZEN with SBL/CSS/XBL/PBL decoded, SpamCop, PSBL, Mailspike; a domain and its parents: Spamhaus DBL, URIBL, SURBL). A domain is also resolved and each A/AAAA address is checked the same way, in `addresses` (each with `ip`, `listed`, `traffic`, `indicators`, `dnsbl`). A list whose own test entry failed is named in `unknown`, not treated as a miss. Not listed is not the same as clean.

Argument	Type	Description
indicator*	string	An IP address or a domain, e.g. 203.0.113.9 or evil.example

Input schema (JSON)

{
  "type": "object",
  "required": [
    "indicator"
  ],
  "properties": {
    "indicator": {
      "type": "string",
      "description": "An IP address or a domain, e.g. 203.0.113.9 or evil.example"
    }
  }
}

run_source

Fetch a source now instead of waiting for its schedule (needs a key; owner or admin).

Argument	Type	Description
source*	string	Source slug

Input schema (JSON)

{
  "type": "object",
  "required": [
    "source"
  ],
  "properties": {
    "source": {
      "type": "string",
      "description": "Source slug"
    }
  }
}

search_items

Full-text search over titles, summaries and tags. Use this first when you know a name.

Argument	Type	Description
q*	string	Query
lat	number	Query center latitude; requires long
bbox	string	west,south,east,north; west > east crosses the antimeridian
kind	string	Item kind
long	number	Query center longitude; requires lat
sort	string
unit	string	Default km
limit	integer	Default 20, max 100
radius	number	Default 10; maximum 1000 km
collection	string	Collection slug

Input schema (JSON)

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Query"
    },
    "lat": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Query center latitude; requires long"
    },
    "bbox": {
      "type": "string",
      "description": "west,south,east,north; west > east crosses the antimeridian"
    },
    "kind": {
      "type": "string",
      "description": "Item kind"
    },
    "long": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Query center longitude; requires lat"
    },
    "sort": {
      "enum": [
        "id",
        "published",
        "updated",
        "distance"
      ],
      "type": "string"
    },
    "unit": {
      "enum": [
        "km",
        "mi"
      ],
      "type": "string",
      "description": "Default km"
    },
    "limit": {
      "type": "integer",
      "description": "Default 20, max 100"
    },
    "radius": {
      "type": "number",
      "description": "Default 10; maximum 1000 km",
      "exclusiveMinimum": 0
    },
    "collection": {
      "type": "string",
      "description": "Collection slug"
    }
  }
}

search_profiles

People: one entry per person assembled from every app that serves their OpenProfile.md (podcasters from p0dcasters, public profiles from OutreachGraph). Search by name, headline or anything in the document; newest change first. Each answer carries the page, the openprofile.md URL, accounts, topics, Broadcast shows, the Guest section, and the job title, company and seniority the person published (filter on them with title, company, seniority or tags).

Argument	Type	Description
q	string	Text to match against the name, headline and document (optional)
tags	array	Facet tags every result must carry: title:…, company:…, seniority:…
limit	integer	Default 30, max 200
since	string	ISO time: only profiles changed after it (optional)
title	string	Job title, matched as its tag (`CTO` is title:cto) (optional)
company	string	Company domain, URL or name (optional)
seniority	string	Seniority derived from the title (optional)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Text to match against the name, headline and document (optional)"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Facet tags every result must carry: title:…, company:…, seniority:…"
    },
    "limit": {
      "type": "integer",
      "description": "Default 30, max 200"
    },
    "since": {
      "type": "string",
      "description": "ISO time: only profiles changed after it (optional)"
    },
    "title": {
      "type": "string",
      "description": "Job title, matched as its tag (`CTO` is title:cto) (optional)"
    },
    "company": {
      "type": "string",
      "description": "Company domain, URL or name (optional)"
    },
    "seniority": {
      "enum": [
        "c-suite",
        "vp",
        "director",
        "manager",
        "senior",
        "entry"
      ],
      "type": "string",
      "description": "Seniority derived from the title (optional)"
    }
  }
}

search_tlds

Top-level domains: every label in IANA's root, with type, registry, RDAP server and each registrar's one-year register/renew/transfer price (Porkbun, Dynadot, Cloudflare, OVHcloud). Sorted by renewal by default, because the first year is a promotion. `best` is the cheapest USD price across registrars; with `registrar` it is that registrar's own price in its currency. Answers carry facet counts. `trap: true` keeps only labels that renew at 2x the first year or more.

Argument	Type	Description
q	string	Text in the label, its Unicode form or the registry name (optional)
idn	boolean	true: internationalised labels only; false: ASCII only
sort	string	renew (default), register, transfer, restore, ratio, tld, registrars, type, manager, first_seen
trap	boolean	Only labels renewing at 2x the first year or more
type	string	generic, country-code, sponsored, generic-restricted, infrastructure, test; comma separated (optional)
limit	integer	Default 50, max 500
order	string	asc or desc
offset	integer	Default 0
status

stats

What this deployment holds: collections, sources, items, items added today, feeds.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

submit_feed

Suggest an RSS or Atom feed for the index. No key needed. An admin reviews every suggestion before anything is fetched; approved podcast feeds are handed to rssamplifier, everything else becomes a source here.

Argument	Type	Description
url*	string	The feed URL, starting with https://
note	string	Why it belongs here: who publishes it, what it covers (optional)
email	string	Where to hear back, if you are not sending a key (optional)
collection	string	Collection slug it belongs in (optional; an admin decides otherwise)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "The feed URL, starting with https://"
    },
    "note": {
      "type": "string",
      "description": "Why it belongs here: who publishes it, what it covers (optional)"
    },
    "email": {
      "type": "string",
      "description": "Where to hear back, if you are not sending a key (optional)"
    },
    "collection": {
      "type": "string",
      "description": "Collection slug it belongs in (optional; an admin decides otherwise)"
    }
  }
}

tld_changes

Top-level domains added to or removed from IANA's root, newest first, with the IANA list version each happened in. Nobody else publishes this diff.

Argument	Type	Description
limit	integer	Default 100, max 1000
since	string	ISO time: only changes after it (optional)
change	string	added, removed or returned (optional)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Default 100, max 1000"
    },
    "since": {
      "type": "string",
      "description": "ISO time: only changes after it (optional)"
    },
    "change": {
      "type": "string",
      "description": "added, removed or returned (optional)"
    }
  }
}

traffic_list

The nichedb /traffic blocklist: IP addresses our own servers banned for exploit attempts, scanning, brute force or spam, each published only after a reviewer (a person, or riotcoder applying published rules) read the evidence and approved it. Newest approvals first. Optional `days` keeps addresses seen in the last N days, `category` one of exploit, brute-force, scanner, spam, other. Without an API key the newest 100 are returned; with one, `limit` (up to 1000) and `offset` page the whole list.

Argument	Type	Description
days	number	Only addresses seen in the last N days (optional)
limit	number	Rows to return, up to 1000 with an API key
offset	number	Rows to skip, with an API key
category	string	exploit, brute-force, scanner, spam or other (optional)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "description": "Only addresses seen in the last N days (optional)"
    },
    "limit": {
      "type": "number",
      "description": "Rows to return, up to 1000 with an API key"
    },
    "offset": {
      "type": "number",
      "description": "Rows to skip, with an API key"
    },
    "category": {
      "type": "string",
      "description": "exploit, brute-force, scanner, spam or other (optional)"
    }
  }
}

upcoming

Items dated in the future (releases, launches, deadlines), soonest first.

Argument	Type	Description
lat	number	Query center latitude; requires long
bbox	string	west,south,east,north; west > east crosses the antimeridian
days	integer	Horizon, default 30
long	number	Query center longitude; requires lat
sort	string
unit	string	Default km
limit	integer	Default 50
radius	number	Default 10; maximum 1000 km
collection	string	Collection slug

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Query center latitude; requires long"
    },
    "bbox": {
      "type": "string",
      "description": "west,south,east,north; west > east crosses the antimeridian"
    },
    "days": {
      "type": "integer",
      "description": "Horizon, default 30"
    },
    "long": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Query center longitude; requires lat"
    },
    "sort": {
      "enum": [
        "id",
        "published",
        "updated",
        "distance"
      ],
      "type": "string"
    },
    "unit": {
      "enum": [
        "km",
        "mi"
      ],
      "type": "string",
      "description": "Default km"
    },
    "limit": {
      "type": "integer",
      "description": "Default 50"
    },
    "radius": {
      "type": "number",
      "description": "Default 10; maximum 1000 km",
      "exclusiveMinimum": 0
    },
    "collection": {
      "type": "string",
      "description": "Collection slug"
    }
  }
}

update_profile

Edit a profile you own (needs a key). Send `markdown`, a whole OpenProfile.md that replaces what you wrote before, or any of `name`, `headline`, `emoji`, `pronouns`, `web`, `identity` (key: value, null removes), `sections` (name: body, `none` removes), `handle`, `public`. What you write wins over every source and survives every re-read.

Argument	Type	Description
ref*	string	Profile id, slug-id or handle
web	string	Your home page (Website, Homepage and Site are the same key); empty removes
name	string	The name
emoji	string	Your mark next to your name: one emoji or an OpenEmoji :shortcode:; empty removes
handle	string	Your URL: /c/profiles/<handle>
public	boolean	Listed and pulled by other directories
headline	string	One line
identity	object	Identity keys: Kind, Emoji, Pronouns, Web, Email, Location, ...; null removes
markdown	string	A complete OpenProfile.md