domainstack.io

Domainstack.io provides a unified MCP server interface for performing AI-assisted domain lookups and intelligence queries. The MCP server exposes tools that let you query domain reports, ownership/verification status, DNS and WHOIS-like data, and provider metadata, all integrated with AI-driven natural language capabilities to answer questions about a domain. Use the server to run lookups, fetch domain health signals, and leverage the AI assistant to interpret results or generate follow-up actions. The system is designed to work with structured domain data and can be extended to include caching, rate limiting, and background jobs for large batch requests through the underlying platform configuration.

Prerequisites:

• Git
• Node.js (recommended LTS) and pnpm
• Access to a Postgres database for domain stack data (as configured by the project)

1. Clone the repository:

git clone https://github.com/jakejarvis/domainstack.io.git
cd domainstack.io

2. Install dependencies (using pnpm):

pnpm install

3. Configure environment variables

• Copy the example environment file for the web app and adjust values as needed:

cp apps/web/.env.example apps/web/.env.local

• Ensure a Postgres connection string is provided in DATABASE_URL and other required secrets are set in apps/web/.env.local

4. Initialize and run migrations (if applicable to your setup):

pnpm db:migrate

5. Start the development server:

pnpm dev

6. Open the app in your browser:

http://localhost:3000

Notes:

• This repository is a Turborepo monorepo; you may need to run additional setup for other apps/packages as needed.
• If you deploy to production, you will likely replace the dev server with your chosen environment (Vercel, Docker, etc.).

Tips and common issues:

• Ensure DATABASE_URL is reachable from the app container and has proper permissions.
• When running locally, you may need to install additional tools or dependencies specified by the monorepo (e.g., Drizzle migrations tooling).
• If you encounter port conflicts, adjust the start script or environment to use an available port.
• For AI-assisted domain queries, ensure any required API keys or gateway configurations for AI services are provided in the environment.
• Review turborepo configuration (turbo.json) to understand task scopes and caching behavior for faster development iterations.