Server definition

Hash: sha256:3227aa6d42f50e4b71e0cb5c570c9acd43bafe0f50cf398b3e745c3fa2500feb
What it is: What a remote MCP server returned when asked what it offers: 15 tools

The blob, as servednamed by its sha256

{
  "instructions": null,
  "tools": [
    {
      "description": "Audit a whole MCP client config in one call (.mcp.json, claude_desktop_config.json, .cursor/mcp.json, .vscode/mcp.json, Codex config.toml text). Resolves every entry without guessing (url → remote_url, npx → npm package, uvx → PyPI package) and returns one PASS / REVIEW / BLOCK / UNKNOWN verdict per entry under a built-in policy, plus CENSUS-AUDIT/1 text, valid_until_epoch and exit_code (1 on any BLOCK). UNKNOWN is never upgraded to PASS. Cost 1 credit per config per UTC day; keyless callers get one config of ≤25 entries per IP per day. Not a malware scan; PASS is not a sandbox. Strip env/headers before sending.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "config": {
            "anyOf": [
              {
                "type": "object"
              },
              {
                "type": "string"
              },
              {
                "type": "array"
              }
            ],
            "description": "The config document: an object with mcpServers | servers | mcp_servers, a list under entries[], or raw text (JSON or Codex config.toml)"
          },
          "format": {
            "enum": [
              "json",
              "toml"
            ],
            "type": "string"
          },
          "policy_id": {
            "default": "builtin:baseline",
            "enum": [
              "builtin:baseline",
              "builtin:first-party",
              "builtin:strict"
            ],
            "type": "string"
          },
          "previous_tools_digests": {
            "additionalProperties": {
              "type": "string"
            },
            "description": "alias → tools_digest from your last audit; sets tools_drift per entry",
            "type": "object"
          },
          "strict": {
            "default": false,
            "description": "exit_code 2 when any entry is REVIEW or UNKNOWN",
            "type": "boolean"
          }
        },
        "required": [
          "config"
        ],
        "type": "object"
      },
      "name": "census_audit_config",
      "outputSchema": null
    },
    {
      "description": "The Census change feed (CENSUS-CHANGES/1): observed transitions across every server — server_new, remote_down, remote_up, tools_changed, health_change, verified_change, security, endpoint_moved, registry_status, spec_era_change. Cursor-paginated: pass next_cursor back as since. Filter by events, server_names or namespace_domain. Only real transitions, never 'still fine'. Unmetered in v1; poll hourly. Not a malware scan.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "events": {
            "description": "Event names to include (default all)",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "limit": {
            "default": 100,
            "maximum": 200,
            "minimum": 1,
            "type": "integer"
          },
          "namespace_domain": {
            "description": "Registrable domain of a DNS-verified namespace, e.g. notion.com",
            "type": "string"
          },
          "server_names": {
            "description": "Exact canonical names to include (≤50)",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "since": {
            "description": "next_cursor from the previous page, or an RFC 3339 time for the first call",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "census_changes",
      "outputSchema": null
    },
    {
      "description": "Public transparency report (same payload as GET /v1/coverage). Unmetered. Live D1 census/identity/remote/protocol/adoption/pipeline counts plus method notes — never invents completeness percentages or a brand_audit punch list.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "census_coverage",
      "outputSchema": null
    },
    {
      "description": "Show remaining Census credits for this API key (wallet after the UTC-month grant). Unmetered. Without a key, returns anonymous unique-per-day remaining — not a wallet.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "census_credits",
      "outputSchema": null
    },
    {
      "description": "Contested identity for one exact server_name: official_for, name_collision_count, and up to 10 other census server_name values sharing the same namespace brand or tail. Never invents lookalikes. Cost 1.",
      "inputSchema": {
        "properties": {
          "server_name": {
            "description": "Exact canonical Census server name",
            "type": "string"
          }
        },
        "required": [
          "server_name"
        ],
        "type": "object"
      },
      "name": "census_lookalikes",
      "outputSchema": null
    },
    {
      "description": "Get the live health verdict for one MCP server by its exact registry name (e.g. 'io.github.owner/name'). Returns stars, last-push recency, gone/archived/deprecated flags, name-collision count, and a fact-based health verdict (healthy | issues | unknown).",
      "inputSchema": {
        "properties": {
          "name": {
            "description": "Exact MCP registry server name",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "name": "census_lookup",
      "outputSchema": null
    },
    {
      "description": "List the exact immutable Preflight v1 built-in policy objects, canonical ruleset, and policy digests. Unmetered.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "census_policy_list",
      "outputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "audit_signed": {
            "const": false
          },
          "ok": {
            "const": true
          },
          "policies": {
            "items": {
              "type": "object"
            },
            "maxItems": 3,
            "minItems": 3,
            "type": "array"
          },
          "policy_digests": {
            "additionalProperties": {
              "pattern": "^sha256:",
              "type": "string"
            },
            "type": "object"
          },
          "ruleset": {
            "type": "object"
          }
        },
        "required": [
          "ok",
          "policies",
          "ruleset",
          "policy_digests",
          "audit_signed"
        ],
        "type": "object"
      }
    },
    {
      "description": "Evaluate one exact MCP server under a documented built-in install policy. Returns PASS, REVIEW, or BLOCK with evidence reasons, freshness, digests, and explicit limits. This is a first gate, not a security audit. refresh=if_stale requires x-api-key.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "policy_id": {
            "default": "builtin:baseline",
            "enum": [
              "builtin:baseline",
              "builtin:first-party",
              "builtin:strict"
            ],
            "type": "string"
          },
          "refresh": {
            "default": "never",
            "enum": [
              "never",
              "if_stale"
            ],
            "type": "string"
          },
          "server_name": {
            "description": "Exact canonical Census server name",
            "maxLength": 300,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "server_name"
        ],
        "type": "object"
      },
      "name": "census_preflight",
      "outputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "audit_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "audit_signed": {
            "const": false
          },
          "decision": {
            "enum": [
              "PASS",
              "REVIEW",
              "BLOCK"
            ],
            "type": "string"
          },
          "decision_input_digest": {
            "pattern": "^sha256:",
            "type": "string"
          },
          "decision_scope": {
            "const": "public_evidence_policy"
          },
          "engine_version": {
            "type": "string"
          },
          "evaluated_at": {
            "format": "date-time",
            "type": "string"
          },
          "facts": {
            "type": "object"
          },
          "facts_digest": {
            "pattern": "^sha256:",
            "type": "string"
          },
          "limitations": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "meaning": {
            "type": "string"
          },
          "ok": {
            "const": true
          },
          "policy": {
            "additionalProperties": false,
            "properties": {
              "digest": {
                "pattern": "^sha256:",
                "type": "string"
              },
              "id": {
                "type": "string"
              },
              "revision": {
                "minimum": 1,
                "type": "integer"
              }
            },
            "required": [
              "id",
              "revision",
              "digest"
            ],
            "type": "object"
          },
          "reasons": {
            "items": {
              "properties": {
                "code": {
                  "type": "string"
                },
                "evidence": {
                  "items": {
                    "type": "object"
                  },
                  "type": "array"
                },
                "result": {
                  "type": "string"
                },
                "summary": {
                  "type": "string"
                }
              },
              "required": [
                "code",
                "result",
                "summary",
                "evidence"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "server_name": {
            "type": "string"
          },
          "valid_until": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "ok",
          "decision",
          "decision_scope",
          "meaning",
          "server_name",
          "policy",
          "reasons",
          "facts",
          "facts_digest",
          "decision_input_digest",
          "engine_version",
          "evaluated_at",
          "valid_until",
          "audit_id",
          "audit_signed",
          "limitations"
        ],
        "type": "object"
      }
    },
    {
      "description": "Newest MCP servers by real first_seen_at (same payload as GET /v1/recent). Unmetered. Only rows with a known first-seen date — never invents or guesses discovery times. Optional limit 1–50 (default 20).",
      "inputSchema": {
        "properties": {
          "limit": {
            "description": "Max results 1–50 (default 20)",
            "type": "number"
          }
        },
        "type": "object"
      },
      "name": "census_recent",
      "outputSchema": null
    },
    {
      "description": "Search MCP servers by keyword or partial name (e.g. 'github', 'postgres'). Returns ranked matches with health/trust. Also returns: resolved_query (auto typo fix), disambiguate (when unsure), known_brand (we recognize a strong product but it has no official MCP — e.g. CodeRabbit), research (watchlist/confirmed_absent), query_intent (brand_lookup|category|package|install_gate|junk — does not change ranking), intent_cta (preflight when they asked an install-gate question). Prefer official_match=true rows. Never invent servers.",
      "inputSchema": {
        "properties": {
          "limit": {
            "description": "Max results 1–50 (default 20)",
            "type": "number"
          },
          "query": {
            "description": "Keyword or partial server name (>= 2 chars). Typos and space variants are resolved when confident.",
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "type": "object"
      },
      "name": "census_search",
      "outputSchema": null
    },
    {
      "description": "Census stamp for one exact MCP server under a built-in policy. Same input as census_preflight. Returns the preflight body plus compact CENSUS-STAMP/1 text and stamp_json. Cost matches preflight. Never connect without a stamp. PASS is not a malware scan or permission review.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "policy_id": {
            "default": "builtin:baseline",
            "enum": [
              "builtin:baseline",
              "builtin:first-party",
              "builtin:strict"
            ],
            "type": "string"
          },
          "refresh": {
            "default": "never",
            "enum": [
              "never",
              "if_stale"
            ],
            "type": "string"
          },
          "server_name": {
            "description": "Exact canonical Census server name",
            "maxLength": 300,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "server_name"
        ],
        "type": "object"
      },
      "name": "census_stamp",
      "outputSchema": null
    },
    {
      "description": "Ecosystem headline numbers from the live census (same payload as GET /v1/stats). Unmetered. Returns total servers, healthy/issues counts, popular (gh_stars>=1000), remote-capable count, github-linked count, and captured_at. No invented metrics.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "census_stats",
      "outputSchema": null
    },
    {
      "description": "List active per-server watches for this API key. Requires x-api-key.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "census_watch_list",
      "outputSchema": null
    },
    {
      "description": "Subscribe this agent (or a human email) to alerts for ONE specific MCP server. Fires only on real observed changes: remote_down, remote_up, health_change, verified_change, security. Requires x-api-key. Prefer webhook_url (https) so your agent can receive POST callbacks; email optional. Returns a watch id + HMAC secret (X-Census-Signature: sha256=…). Free tier: 5 watches; pro: 50.",
      "inputSchema": {
        "properties": {
          "email": {
            "description": "Optional human email for the same alerts",
            "type": "string"
          },
          "events": {
            "description": "Subset of remote_down,remote_up,health_change,verified_change,security,tools_changed (default: all)",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "label": {
            "description": "Optional agent-chosen label",
            "type": "string"
          },
          "server_name": {
            "description": "Exact registry name to watch",
            "type": "string"
          },
          "webhook_url": {
            "description": "https URL that will receive signed POST event payloads",
            "type": "string"
          }
        },
        "required": [
          "server_name"
        ],
        "type": "object"
      },
      "name": "census_watch_subscribe",
      "outputSchema": null
    },
    {
      "description": "Deactivate a watch by id. Requires x-api-key that owns the watch.",
      "inputSchema": {
        "properties": {
          "id": {
            "description": "Watch id from census_watch_subscribe",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "name": "census_watch_unsubscribe",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:3227aa6d42f50e4b71e0cb5c570c9acd43bafe0f50cf398b3e745c3fa2500feb | sha256sum