Allows AI assistants to query website technology detection data, company research, and digital trends directly through natural language.
Also known as builtwith/builtwith-mcp, builtwith-mcp
- Stars
- 43
- Tools
- 27
- Downloads, 30 days
- —
- Latest version
- 2.1.0
- Last commit
- Nov 10, 2026
- License
- MIT
What is BuiltWith MCP?
BuiltWith allows AI assistants to query website technology detection data, company research, and digital trends directly through natural language. It exposes 27 tools, such as domain-lookup, domain-api, change-api.
Summary generated from the project's README
About BuiltWith MCP server
BuiltWith MCP provides AI assistants like Claude and Cursor with direct access to technology detection data and company research. Developers can use this server to query what software stacks, CMS platforms, or analytics tools specific websites are running. It functions as a bridge that translates natural language questions into structured API calls, returning detailed insights about digital trends and website relationships.
Users can connect via a hosted service at a specific endpoint or choose to self-host the server locally using stdio or HTTP transports. Access requires a BuiltWith API key provided through authorization headers or environment variables. The server includes specialized tools such as domain-lookup for live detection, lists-api for finding sites using specific technologies, and vat-api for retrieving company registration numbers. It also features an agent authorization flow that allows users to grant temporary access via a device code without manually sharing their full API key.
What you can do with it
- 1Identify website technology stacksAsk an AI assistant to determine which CMS or analytics tools a specific domain is currently using.
- 2Discover related web propertiesUse the relationships tool to find websites that are connected to a target domain.
- 3Verify company registration detailsRetrieve official VAT or GST registration numbers for a specific website to assist in company research.
Written from the project's README. Every use case is checked against a quote from it.
How to install BuiltWith MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall BuiltWith MCP in Claude Code
$ claude mcp add --transport http builtwith-mcp https://api.builtwith.com/mcpInstall BuiltWith MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"builtwith-mcp": {
"url": "https://api.builtwith.com/mcp"
}
}
}Install BuiltWith MCP in VS Code
.vscode/mcp.json
{
"servers": {
"builtwith-mcp": {
"type": "http",
"url": "https://api.builtwith.com/mcp"
}
}
}Install BuiltWith MCP in VS Code CLI
$ code --add-mcp '{"name":"builtwith-mcp","type":"http","url":"https://api.builtwith.com/mcp"}'Install BuiltWith MCP in Codex
$ codex mcp add builtwith-mcp --url https://api.builtwith.com/mcpInstall BuiltWith MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.builtwith-mcp] url = "https://api.builtwith.com/mcp"
Install BuiltWith MCP in Gemini CLI
$ gemini mcp add -s user --transport http builtwith-mcp https://api.builtwith.com/mcpInstall BuiltWith MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"builtwith-mcp": {
"url": "https://api.builtwith.com/mcp",
"type": "http"
}
}
}BuiltWith MCP tools 27
Detected from the READMEdomain-lookupdomain-apichange-apilists-apirelationships-apifree-apicompany-to-urltags-apirecommendations-apiredirects-apikeywords-apitrends-api
Show all 27 toolsShow fewer tools
product-apitrust-apivat-apivat-types-apiwhoami-apiusage-apimcp-registry-apimcp-registry-v2-apivector-searchask-apipayment-balancepayment-configpayment-purchaseagent-auth-startagent-auth-token
Configuration
BUILTWITH_API_KEYMCP_TRANSPORT
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packageNot checked
- Remote endpoint uses HTTPSPass
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHub🔍 BuiltWith MCP Server 🚀
Current API endpoints
Uses Domain v26, Lists v13, Relationships v5, and MCP Registry v2 where supported. Existing unversioned registry methods now use v2; explicit v2 aliases remain available. Registry JSON is an array with per-endpoint tools and discovery Overview objects.
Relationships requests return one page (up to 1000 records). Pass next_page as PAGE while more_results is true, keeping the lookup domain and IP option unchanged. OFFSET and SKIP are not supported. Bulk Domain retains its separate /v23/domain/bulk routes.
Domain API v26
Domain lookups now use API v26. Technology records include numeric confidence scores from 0 to 1. Full JSON responses include Meta.company_reg, an array of company registration records with string type and number fields; registration numbers preserve leading zeros. The array is empty when unavailable or metadata is excluded. See the API reference. Full domain methods preserve both fields; live technology lookups include confidence and return technology records only.
🌟 Overview
BuiltWith MCP is a Model Context Protocol (MCP) server that allows AI assistants (Claude, Cursor, IDE agents, etc.) to query BuiltWith’s technology detection data directly and natively.
It enables natural-language questions like:
“What technologies does example.com use?” “Does this site run Shopify or Magento?” “What analytics stack is used by nytimes.com?”
BuiltWith MCP supports bring-your-own BuiltWith API key and can be used either as a hosted service or self-hosted.
Claude DEMO
Shows how to get this working in Claude as a Connector
https://github.com/user-attachments/assets/1199362a-c813-497e-8569-15b9a3ce9713
🌐 Hosted MCP (Recommended)
BuiltWith provides a hosted MCP endpoint — no local Node process required.
Endpoint
https://api.builtwith.com/mcp
Authentication
Bring your own BuiltWith API key:
Authorization: Bearer YOUR_BUILTWITH_API_KEY
Example MCP request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}
Python SDK integration
The official Python SDK connects to
this existing hosted MCP server. Install pip install "builtwith-official[mcp]"
and set BUILTWITH_API_KEY in your environment:
from builtwith_official.mcp import connect_mcp
async def discover_tools() -> None:
async with connect_mcp() as session:
print(await session.list_tools())
# Uses API credits when invoked:
# result = await session.call_tool("domain-api", {"lookup": "example.com"})
The client uses the existing tool names and schemas; it does not run another server. See the Python MCP guide.
🧩 Supported Tools
The hosted MCP exposes the following tools:
domain-lookup– Live technology detection for a domaindomain-api– Full domain metadatachange-api– Technology additions and removals with business contextlists-api– Sites using a technology, includingOTHERTECHSand numeric attribute filters such asSPEND,REVENUE, andEMPLOYEESrelationships-api– Related websitesfree-api– Category and group countscompany-to-url– Company → domain discoverytags-api– IP / attribute based discoveryrecommendations-api– Technology recommendationsredirects-api– Live and historical redirectskeywords-api– Keyword intelligencetrends-api– Technology trend dataproduct-api– Ecommerce product searchtrust-api– Trust scoringvat-api– VAT, GST, and other company registration numbers for websitesvat-types-api– Reference list of registration types returned byvat-api(no API key required)whoami-api– Account limits, credit costs, and endpoint inventory (no API credits)usage-api– Current credit balance (no API credits)mcp-registry-api– Search and browse the BuiltWith MCP registry (v1) of other remote MCP servers (no API credits)mcp-registry-v2-api– Search and browse the BuiltWith MCP registry (v2) of other remote MCP servers, with per-endpoint auth flags and first/last detected dates (no API credits)vector-search– Semantic similarity search across technologies and categoriesask-api– Natural language website list lookup (e.g. "Magento websites in Spain"); supports full reports and paginationpayment-balance– Check your API credit balancepayment-config– Retrieve your payment configurationpayment-purchase– Purchase API credits using your saved Stripe payment methodagent-auth-start– Start Agent Device-Code Authorization (no API key required)agent-auth-token– Poll for authorization result and retrieve access token (no API key required)
⚙️ Client Configuration (Claude, Cursor, IDEs)
Add BuiltWith MCP to your MCP-compatible client configuration.
Example
{
"mcpServers": {
"builtwith": {
"url": "https://api.builtwith.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_BUILTWITH_API_KEY"
}
}
}
}
Configuration locations
-
Claude Desktop
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
-
Cursor / Claude Dev (VS Code)
- macOS:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json - Windows:
%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
- macOS:
🛠️ Self-Hosting (Optional)
You can also run the BuiltWith MCP server locally or inside your own infrastructure.
What changed (February 14, 2026)
The local server now supports both standard MCP transports:
stdio(default) for local MCP clients like Claude Desktop/Cursorhttpfor remote/connector style MCP usage on/mcp
Installation
git clone https://github.com/builtwith/builtwith-mcp.git
cd builtwith-mcp
npm install
Local (stdio) MCP configuration
{
"mcpServers": {
"builtwith": {
"command": "node",
"args": ["[PATH-TO]/bw-mcp-v1.js"],
"env": {
"BUILTWITH_API_KEY": "YOUR_BUILTWITH_API_KEY"
}
}
}
}
Note: The hosted endpoint is recommended for most users. Self-hosting is useful if you need custom routing, rate-limiting, or private network access.
Local HTTP MCP endpoint
Run in HTTP mode:
MCP_TRANSPORT=http PORT=8787 node bw-mcp-v1.js
MCP endpoint:
http://127.0.0.1:8787/mcp
Optional headers/environment:
Authorization: Bearer YOUR_BUILTWITH_API_KEY(per-request API key for HTTP mode)BUILTWITH_API_KEY(used by stdio mode, and as fallback when no HTTP bearer token is provided)MCP_ALLOWED_ORIGINS(comma-separated CORS/origin allowlist for HTTP mode)
Health check:
http://127.0.0.1:8787/health
🔐 Agent Device-Code Authorization
Agents can obtain a temporary bw- prefixed API token without the user pasting their key — the user approves access in their browser.
Flow:
- Call
agent-auth-start→ receivedevice_codeandverification_uri - Direct the user to open
verification_uriin their browser - Poll
agent-auth-tokenevery 5 seconds with thedevice_code - On approval, receive an
access_token(bw-...) valid for the chosen duration (1 hour / 1 day / 30 days) - Use the token as
KEY=bw-...on any BuiltWith API endpoint
No API key is required to call agent-auth-start or agent-auth-token.
🚀 Usage Examples
Once configured, try asking your AI assistant:
- “What technologies is example.com using?”
- “What CMS does nytimes.com run on?”
- “Does amazon.com use Google Analytics?”
- “What JavaScript frameworks are used by spotify.com?”
- “What hosting provider does netflix.com use?”
- “Compare the technology stacks of facebook.com and twitter.com”
🧠 How It Works
- 🗣️ User asks a technology question in an AI assistant
- 🔌 The assistant calls the BuiltWith MCP server
- 🔍 MCP translates intent into BuiltWith API calls
- 📊 BuiltWith returns structured technology data
- 💬 The AI assistant presents human-friendly insights
📖 BuiltWith API Documentation
📄 License
MIT License — see the LICENSE file for details.
Built for AI-native workflows by BuiltWith
Just say which.
BuiltWith MCP questions
How do I add BuiltWith MCP to Claude Code?
Run claude mcp add --transport http builtwith-mcp https://api.builtwith.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add BuiltWith MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does BuiltWith MCP provide?
It exposes 27 tools, including domain-lookup, domain-api, change-api, lists-api, relationships-api.
Can agents authenticate without the user sharing their full API key?
Yes, using Agent Device-Code Authorization, agents can obtain a temporary access token after the user approves access in a browser.