Server definition

Hash: sha256:95bf75d582ea0b35122bdf3460868356ac5304e4f95e01e82e312cd3018c15f6
What it is: What a remote MCP server returned when asked what it offers: 26 tools

The blob, as servednamed by its sha256

{
  "instructions": "NicheDB is an open, ever-growing database of real-time public data: collections\n(games, packages, filings, ...), each fed by sources that fetch on a schedule, cut into\nfeeds people follow. Anyone may read; a key is needed only to write.\n\nStart with `search_items` when you know a name, `recent_items` or `feed_items` to see what\nis new, and `upcoming` for anything dated in the future. `list_collections` and `list_feeds`\nsay what exists. Every item carries `time_known`: when it is false, the date is real and\nthe clock is not, so never say \"at 12:00\" for one of those.\n\nWith a key (Authorization: Bearer ndb_…) you can `create_feed`, `follow_feed`, and on\ndeployments that allow it `add_source` and `run_source`.",
  "tools": [
    {
      "description": "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.",
      "inputSchema": {
        "properties": {
          "adapter": {
            "description": "Adapter name, e.g. github-releases",
            "type": "string"
          },
          "cadence_minutes": {
            "description": "5 to 1440",
            "type": "integer"
          },
          "collection": {
            "description": "Collection slug; defaults to the adapter's",
            "type": "string"
          },
          "config": {
            "description": "Adapter config fields",
            "type": "object"
          },
          "name": {
            "description": "Display name",
            "type": "string"
          }
        },
        "required": [
          "adapter"
        ],
        "type": "object"
      },
      "name": "add_source",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "properties": {
          "name": {
            "description": "foo.watches, or foo, or a.com,b.dev",
            "type": "string"
          },
          "tlds": {
            "description": "Endings to try a bare word under, comma separated (optional)",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "name": "check_domain",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "properties": {
          "email": {
            "description": "Admins only: claim it for this email",
            "type": "string"
          },
          "ref": {
            "description": "Profile id, slug-id or handle",
            "type": "string"
          }
        },
        "required": [
          "ref"
        ],
        "type": "object"
      },
      "name": "claim_profile",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "properties": {
          "bbox": {
            "description": "west,south,east,north; west > east crosses the antimeridian",
            "type": "string"
          },
          "collection": {
            "description": "Collection slug",
            "type": "string"
          },
          "description": {
            "description": "Optional",
            "type": "string"
          },
          "enrichers": {
            "description": "Enrichers to show; omit for the collection defaults",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "kinds": {
            "description": "Item kinds",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "lat": {
            "description": "Query center latitude; requires long",
            "maximum": 90,
            "minimum": -90,
            "type": "number"
          },
          "long": {
            "description": "Query center longitude; requires lat",
            "maximum": 180,
            "minimum": -180,
            "type": "number"
          },
          "name": {
            "description": "Feed name",
            "type": "string"
          },
          "public": {
            "description": "Default true",
            "type": "boolean"
          },
          "q": {
            "description": "Text match",
            "type": "string"
          },
          "radius": {
            "description": "Default 10; maximum 1000 km",
            "exclusiveMinimum": 0,
            "type": "number"
          },
          "sort": {
            "enum": [
              "id",
              "published",
              "updated",
              "distance"
            ],
            "type": "string"
          },
          "sources": {
            "description": "Source slugs",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "tags": {
            "description": "Tags, any match",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "unit": {
            "description": "Default km",
            "enum": [
              "km",
              "mi"
            ],
            "type": "string"
          },
          "upcoming": {
            "type": "boolean"
          }
        },
        "required": [
          "collection",
          "name"
        ],
        "type": "object"
      },
      "name": "create_feed",
      "outputSchema": null
    },
    {
      "description": "What a feed selects, newest first. Page with before_id.",
      "inputSchema": {
        "properties": {
          "bbox": {
            "description": "west,south,east,north; west > east crosses the antimeridian",
            "type": "string"
          },
          "before_id": {
            "description": "Keyset cursor; cannot combine with distance sorting",
            "type": "integer"
          },
          "feed": {
            "description": "Feed slug",
            "type": "string"
          },
          "lat": {
            "description": "Query center latitude; requires long",
            "maximum": 90,
            "minimum": -90,
            "type": "number"
          },
          "limit": {
            "description": "Default 30, max 200",
            "type": "integer"
          },
          "long": {
            "description": "Query center longitude; requires lat",
            "maximum": 180,
            "minimum": -180,
            "type": "number"
          },
          "offset": {
            "description": "Distance pagination offset",
            "type": "integer"
          },
          "radius": {
            "description": "Default 10; maximum 1000 km",
            "exclusiveMinimum": 0,
            "type": "number"
          },
          "sort": {
            "enum": [
              "id",
              "published",
              "updated",
              "distance"
            ],
            "type": "string"
          },
          "unit": {
            "description": "Default km",
            "enum": [
              "km",
              "mi"
            ],
            "type": "string"
          }
        },
        "required": [
          "feed"
        ],
        "type": "object"
      },
      "name": "feed_items",
      "outputSchema": null
    },
    {
      "description": "Follow a feed as the key owner (needs a key). Channels: webpush, email, webhook.",
      "inputSchema": {
        "properties": {
          "channels": {
            "description": "Default webpush,email",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "feed": {
            "description": "Feed slug",
            "type": "string"
          },
          "webhook_secret": {
            "description": "Shared secret the receiver verifies with",
            "type": "string"
          },
          "webhook_url": {
            "description": "For the webhook channel",
            "type": "string"
          }
        },
        "required": [
          "feed"
        ],
        "type": "object"
      },
      "name": "follow_feed",
      "outputSchema": null
    },
    {
      "description": "One item with its full adapter payload.",
      "inputSchema": {
        "properties": {
          "id": {
            "description": "Item id",
            "type": "integer"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "name": "get_item",
      "outputSchema": null
    },
    {
      "description": "One person by id, `<slug>-<id>` or handle: the parsed view and the OpenProfile.md as served.",
      "inputSchema": {
        "properties": {
          "ref": {
            "description": "Profile id, slug-id or handle",
            "type": "string"
          }
        },
        "required": [
          "ref"
        ],
        "type": "object"
      },
      "name": "get_profile",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "properties": {
          "tld": {
            "description": "The label, with or without the dot; Unicode or xn-- both work",
            "type": "string"
          }
        },
        "required": [
          "tld"
        ],
        "type": "object"
      },
      "name": "get_tld",
      "outputSchema": null
    },
    {
      "description": "Every adapter this deployment can run, with the config fields each takes. Use before add_source.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "list_adapters",
      "outputSchema": null
    },
    {
      "description": "The collections (niches) with their source, feed and item counts.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "list_collections",
      "outputSchema": null
    },
    {
      "description": "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`.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "list_enrichers",
      "outputSchema": null
    },
    {
      "description": "Public feeds, most followed first. Optionally one collection.",
      "inputSchema": {
        "properties": {
          "collection": {
            "description": "Collection slug",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "list_feeds",
      "outputSchema": null
    },
    {
      "description": "Sources with status, last run and item counts. Optionally one collection.",
      "inputSchema": {
        "properties": {
          "collection": {
            "description": "Collection slug, e.g. games",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "list_sources",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "properties": {
          "bbox": {
            "description": "west,south,east,north; west > east crosses the antimeridian",
            "type": "string"
          },
          "collection": {
            "description": "Collection slug: screen, channels or sports",
            "type": "string"
          },
          "date": {
            "description": "A day (YYYY-MM-DD) to look for a fixture on, plus a day either side",
            "type": "string"
          },
          "kind": {
            "description": "Item kind: title, channel, fixture",
            "type": "string"
          },
          "lat": {
            "description": "Query center latitude; requires long",
            "maximum": 90,
            "minimum": -90,
            "type": "number"
          },
          "limit": {
            "description": "Default 5, max 50",
            "type": "integer"
          },
          "long": {
            "description": "Query center longitude; requires lat",
            "maximum": 180,
            "minimum": -180,
            "type": "number"
          },
          "q": {
            "description": "The name as written",
            "type": "string"
          },
          "radius": {
            "description": "Default 10; maximum 1000 km",
            "exclusiveMinimum": 0,
            "type": "number"
          },
          "sort": {
            "enum": [
              "id",
              "published",
              "updated",
              "distance"
            ],
            "type": "string"
          },
          "unit": {
            "description": "Default km",
            "enum": [
              "km",
              "mi"
            ],
            "type": "string"
          },
          "year": {
            "description": "A year to prefer, when known",
            "type": "integer"
          }
        },
        "required": [
          "q"
        ],
        "type": "object"
      },
      "name": "match_items",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "properties": {
          "key": {
            "description": "Area key, e.g. us, us-ca, us-ca-los-angeles, us-90210, de (optional)",
            "type": "string"
          },
          "level": {
            "description": "Which children to list: country, state, city or zip (optional)",
            "type": "string"
          },
          "limit": {
            "description": "Children to list, default 20, max 500",
            "type": "integer"
          },
          "offset": {
            "description": "Skip this many children, for paging",
            "type": "integer"
          },
          "q": {
            "description": "A place name to look up, e.g. Springfield (optional)",
            "type": "string"
          },
          "zip": {
            "description": "A US ZIP code (optional)",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "population",
      "outputSchema": null
    },
    {
      "description": "Newest items, optionally narrowed to a collection, source or kind.",
      "inputSchema": {
        "properties": {
          "bbox": {
            "description": "west,south,east,north; west > east crosses the antimeridian",
            "type": "string"
          },
          "before_id": {
            "description": "Keyset cursor; cannot combine with distance sorting",
            "type": "integer"
          },
          "collection": {
            "description": "Collection slug",
            "type": "string"
          },
          "kind": {
            "description": "Item kind",
            "type": "string"
          },
          "lat": {
            "description": "Query center latitude; requires long",
            "maximum": 90,
            "minimum": -90,
            "type": "number"
          },
          "limit": {
            "description": "Default 30, max 200",
            "type": "integer"
          },
          "long": {
            "description": "Query center longitude; requires lat",
            "maximum": 180,
            "minimum": -180,
            "type": "number"
          },
          "offset": {
            "description": "Distance pagination offset",
            "type": "integer"
          },
          "radius": {
            "description": "Default 10; maximum 1000 km",
            "exclusiveMinimum": 0,
            "type": "number"
          },
          "sort": {
            "enum": [
              "id",
              "published",
              "updated",
              "distance"
            ],
            "type": "string"
          },
          "source": {
            "description": "Source slug",
            "type": "string"
          },
          "unit": {
            "description": "Default km",
            "enum": [
              "km",
              "mi"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "recent_items",
      "outputSchema": null
    },
    {
      "description": "Fetch a source now instead of waiting for its schedule (needs a key; owner or admin).",
      "inputSchema": {
        "properties": {
          "source": {
            "description": "Source slug",
            "type": "string"
          }
        },
        "required": [
          "source"
        ],
        "type": "object"
      },
      "name": "run_source",
      "outputSchema": null
    },
    {
      "description": "Full-text search over titles, summaries and tags. Use this first when you know a name.",
      "inputSchema": {
        "properties": {
          "bbox": {
            "description": "west,south,east,north; west > east crosses the antimeridian",
            "type": "string"
          },
          "collection": {
            "description": "Collection slug",
            "type": "string"
          },
          "kind": {
            "description": "Item kind",
            "type": "string"
          },
          "lat": {
            "description": "Query center latitude; requires long",
            "maximum": 90,
            "minimum": -90,
            "type": "number"
          },
          "limit": {
            "description": "Default 20, max 100",
            "type": "integer"
          },
          "long": {
            "description": "Query center longitude; requires lat",
            "maximum": 180,
            "minimum": -180,
            "type": "number"
          },
          "q": {
            "description": "Query",
            "type": "string"
          },
          "radius": {
            "description": "Default 10; maximum 1000 km",
            "exclusiveMinimum": 0,
            "type": "number"
          },
          "sort": {
            "enum": [
              "id",
              "published",
              "updated",
              "distance"
            ],
            "type": "string"
          },
          "unit": {
            "description": "Default km",
            "enum": [
              "km",
              "mi"
            ],
            "type": "string"
          }
        },
        "required": [
          "q"
        ],
        "type": "object"
      },
      "name": "search_items",
      "outputSchema": null
    },
    {
      "description": "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 and the Guest section.",
      "inputSchema": {
        "properties": {
          "limit": {
            "description": "Default 30, max 200",
            "type": "integer"
          },
          "q": {
            "description": "Text to match against the name, headline and document (optional)",
            "type": "string"
          },
          "since": {
            "description": "ISO time: only profiles changed after it (optional)",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "search_profiles",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "properties": {
          "idn": {
            "description": "true: internationalised labels only; false: ASCII only",
            "type": "boolean"
          },
          "limit": {
            "description": "Default 50, max 500",
            "type": "integer"
          },
          "manager": {
            "description": "Exact registry name, as IANA writes it (optional)",
            "type": "string"
          },
          "max_register": {
            "description": "Highest first-year price (optional)",
            "type": "number"
          },
          "max_renew": {
            "description": "Highest renewal price (optional)",
            "type": "number"
          },
          "offset": {
            "description": "Default 0",
            "type": "integer"
          },
          "order": {
            "description": "asc or desc",
            "type": "string"
          },
          "q": {
            "description": "Text in the label, its Unicode form or the registry name (optional)",
            "type": "string"
          },
          "registrar": {
            "description": "porkbun, dynadot, cloudflare, ovh (optional): only labels it sells, at its prices",
            "type": "string"
          },
          "sort": {
            "description": "renew (default), register, transfer, restore, ratio, tld, registrars, type, manager, first_seen",
            "type": "string"
          },
          "status": {
            "description": "delegated (default), removed, or all",
            "type": "string"
          },
          "trap": {
            "description": "Only labels renewing at 2x the first year or more",
            "type": "boolean"
          },
          "type": {
            "description": "generic, country-code, sponsored, generic-restricted, infrastructure, test; comma separated (optional)",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "search_tlds",
      "outputSchema": null
    },
    {
      "description": "What this deployment holds: collections, sources, items, items added today, feeds.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "stats",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "properties": {
          "collection": {
            "description": "Collection slug it belongs in (optional; an admin decides otherwise)",
            "type": "string"
          },
          "email": {
            "description": "Where to hear back, if you are not sending a key (optional)",
            "type": "string"
          },
          "note": {
            "description": "Why it belongs here: who publishes it, what it covers (optional)",
            "type": "string"
          },
          "url": {
            "description": "The feed URL, starting with https://",
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "type": "object"
      },
      "name": "submit_feed",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "properties": {
          "change": {
            "description": "added, removed or returned (optional)",
            "type": "string"
          },
          "limit": {
            "description": "Default 100, max 1000",
            "type": "integer"
          },
          "since": {
            "description": "ISO time: only changes after it (optional)",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "tld_changes",
      "outputSchema": null
    },
    {
      "description": "Items dated in the future (releases, launches, deadlines), soonest first.",
      "inputSchema": {
        "properties": {
          "bbox": {
            "description": "west,south,east,north; west > east crosses the antimeridian",
            "type": "string"
          },
          "collection": {
            "description": "Collection slug",
            "type": "string"
          },
          "days": {
            "description": "Horizon, default 30",
            "type": "integer"
          },
          "lat": {
            "description": "Query center latitude; requires long",
            "maximum": 90,
            "minimum": -90,
            "type": "number"
          },
          "limit": {
            "description": "Default 50",
            "type": "integer"
          },
          "long": {
            "description": "Query center longitude; requires lat",
            "maximum": 180,
            "minimum": -180,
            "type": "number"
          },
          "radius": {
            "description": "Default 10; maximum 1000 km",
            "exclusiveMinimum": 0,
            "type": "number"
          },
          "sort": {
            "enum": [
              "id",
              "published",
              "updated",
              "distance"
            ],
            "type": "string"
          },
          "unit": {
            "description": "Default km",
            "enum": [
              "km",
              "mi"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "upcoming",
      "outputSchema": null
    },
    {
      "description": "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`, `identity` (key: value, null removes), `sections` (name: body, `none` removes), `handle`, `public`. What you write wins over every source and survives every re-read.",
      "inputSchema": {
        "properties": {
          "handle": {
            "description": "Your URL: /c/profiles/<handle>",
            "type": "string"
          },
          "headline": {
            "description": "One line",
            "type": "string"
          },
          "identity": {
            "description": "Identity keys: Kind, Web, Email, Location, ...; null removes",
            "type": "object"
          },
          "markdown": {
            "description": "A complete OpenProfile.md",
            "type": "string"
          },
          "name": {
            "description": "The name",
            "type": "string"
          },
          "public": {
            "description": "Listed and pulled by other directories",
            "type": "boolean"
          },
          "ref": {
            "description": "Profile id, slug-id or handle",
            "type": "string"
          },
          "sections": {
            "description": "Section bodies by name (accounts, topics, broadcast, guest, ...); the word none removes one",
            "type": "object"
          }
        },
        "required": [
          "ref"
        ],
        "type": "object"
      },
      "name": "update_profile",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:95bf75d582ea0b35122bdf3460868356ac5304e4f95e01e82e312cd3018c15f6 | sha256sum