aloth/cred-1

CRED-1 is an open, reproducible domain-level credibility dataset combining multiple openly-licensed source lists with computed enrichment signals. It provides credibility scores for 2,600+ domains (exact count in the latest release) known to publish mis/disinformation, conspiracy theories, or other unreliable content. Community members can report missing domains for inclusion.
> 🎓 Presented at ACM WebSci 2026 (Braunschweig). Landing page: aloth.github.io/agentic-ai-information-integrity/cred-1.
> 🤖 MCP-ready: query domain credibility directly from Claude Desktop, Cursor & Windsurf, or any MCP-compatible agent. Jump to setup ↓
> Paper: A. Loth, M. Kappes, and M.-O. Pahl, "CRED-1: An Open Multi-Signal Domain Credibility Dataset for Automated Pre-Bunking of Online Misinformation," Preprint, 2026. doi:10.2139/ssrn.6448466
## Install
bash
# CLI (global)
npm install -g @aloth/cred1
# Library (project dependency)
npm install @aloth/cred1
# Or try without installing
npx @aloth/cred1 check infowars.com
# Python library, dataset included (pandas optional)
pip install cred1
pip install "cred1[pandas]"
python
import cred1
cred1.check("https://www.infowars.com/article") # dict, or None if not listed
df = cred1.to_dataframe() # whole dataset as a DataFrame
## CLI Usage
bash
# Single domain lookup
cred1 check infowars.com
# 🔴 infowars.com
# Score: 0.073 / 1.000
# Category: conspiracy
# Level: low
# Sources: 2
# Domain not in dataset
cred1 check nytimes.com
# ⚪ nytimes.com
# Not found in CRED-1 dataset: treat as unknown/neutral
# Batch processing (stdin)
echo -e "rt.com\ninfowars.com\nnytimes.com" | cred1 batch
# JSON output
cred1 check breitbart.com --json
# Search
cred1 search "news"
cred1 search "\.ru$"
# Statistics
cred1 stats
cred1 categories
In scripts, cred1 check --exit-code exits 0 when the domain is listed, 1 when it is not and 2 on a usage error. Color follows NO_COLOR and --no-color, and is off when the output is not a terminal. Requires Node 20 or newer.
Domain normalization is automatic: https://www.infowars.com/politics/ resolves to infowars.com.
## MCP Server (Claude Desktop / Cursor / Windsurf)
CRED-1 ships an MCP server so AI assistants can check domain credibility directly.
### Tools exposed
| Tool | Description |
| check_domain | Check a single domain (score, category, level, metadata) |
| batch_check | Check up to 100 domains at once |
| search_domains | Search domains by substring or regex pattern |
| get_stats | Dataset statistics (total, per-category counts, version) |
| get_categories | Category taxonomy with descriptions and score ranges |
### Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
json
"mcpServers": {
"cred1": {
"command": "npx",
"args": ["-y", "@aloth/cred1", "--mcp"]
> Note: --mcp is handled by the CLI wrapper, or run the dedicated binary directly.
Alternatively, if the package is installed globally:
json
"mcpServers": {
"cred1": {
"command": "cred1-mcp"
### Cursor
Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
json
"mcpServers": {
"cred1": {
"command": "npx",
"args": ["-y", "@aloth/cred1", "--mcp"]
### Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
json