Fast domain-level categorization lookups from 100M+ pre-classified domains. Connect your AI assistant to the world's largest website categorization database via the Model Context Protocol.
pip package managergit installedDownload the MCP server source code from GitHub
git clone https://github.com/websitecategorization/mcp-database-lookup.git
cd mcp-database-lookupInstall the required Python packages
pip install -r requirements.txtCreate a .env file with your API credentials
Copy the example environment file and add your API key:
cp .env.example .env
Then edit the .env file:
# Required: Your API key from websitecategorizationapi.com
WCA_API_KEY=your-api-key-here
# Optional: Override the database API endpoint
# WCA_DB_ENDPOINT=https://websitecategorizationapi.com/mcp/v1Add the server to your preferred AI coding assistant
Open your Claude Desktop configuration file and add the server:
{
"mcpServers": {
"website-categorization-database": {
"command": "python",
"args": ["/full/path/to/mcp-database-lookup/wca_mcp_database.py"],
"env": {
"WCA_API_KEY": "your-api-key-here"
}
}
}
}/full/path/to/mcp-database-lookup/ with the actual absolute path where you cloned the repository. Restart Claude Desktop after saving.
Run this command in your terminal to add the MCP server to Claude Code:
claude mcp add website-categorization-database \
python /full/path/to/mcp-database-lookup/wca_mcp_database.py \
-e WCA_API_KEY=your-api-key-here/full/path/to/mcp-database-lookup/ with the actual absolute path where you cloned the repository.
Open Cursor Settings and navigate to MCP. Click "Add new global MCP server" and paste the following configuration:
{
"mcpServers": {
"website-categorization-database": {
"command": "python",
"args": ["/full/path/to/mcp-database-lookup/wca_mcp_database.py"],
"env": {
"WCA_API_KEY": "your-api-key-here"
}
}
}
}Try these example prompts in your MCP client
Five purpose-built MCP tools for domain categorization and database exploration
Look up a single domain and get its full categorization profile including IAB taxonomy, web filtering category, personas, and more.
Look up multiple domains at once. Accepts comma-separated, space-separated, or one per line. Up to 100 domains per request.
Search the database by category and/or country code. Returns matching domains with full categorization data. Max 100 results.
Get high-level statistics about the database: total domains covered, category distribution, country breakdown, and more.
Check your remaining API credits and usage for the current billing month. Monitor your consumption in real time.
Every domain lookup returns these rich categorization fields
| Field | Description | Example |
|---|---|---|
| Domain | The queried domain name | stripe.com |
| IAB v2 Tier 1-4 | IAB Content Taxonomy v2 classification, up to 4 tiers of depth | Technology & Computing → Computing → ... |
| IAB v3 Tier 1-4 | IAB Content Taxonomy v3 classification, up to 4 tiers of depth | Technology & Computing → Computing → ... |
| Web Filtering Category | Content filtering classification for brand safety and parental controls | Business / Finance |
| Personas | Target audience / buyer persona associated with the domain | Software Developer, SaaS Buyer |
| OpenPageRank | Domain authority score from OpenPageRank | 7.82 |
| Country | Primary country associated with the domain | US |
| global_popularity_rank_group | Global traffic/popularity rank group for the domain | Top 1K |
| country_level_popularity_rank_group | Country-level traffic/popularity rank group | Top 500 |
Choose the right MCP server for your use case
| Feature | Database Lookup | Real-Time API |
|---|---|---|
| Speed | Instant (<200ms) | 1-3 seconds (live crawl) |
| Coverage | 100M+ pre-classified domains | Any URL on the internet |
| Subpage Support | Domain-level only | Full URL paths |
| Bulk Lookups | Up to 100 domains | One URL at a time |
| Search & Filter | By category & country | Not available |
| Data Freshness | Periodically updated | Real-time (live analysis) |
| Taxonomies | IAB v2 & v3, Web Filtering, Personas | IAB v2 & v3, Web Filtering, Personas + more |
| Best For | Bulk classification, domain screening, enrichment | URL-level analysis, fresh content |
Our team is here to help you get set up. Reach out through any of these channels for assistance with your MCP server configuration.