Skip to content
← Back to Documentation

AI MCP Integration

MCP Protocol

Connect Claude Desktop, Cursor, or other MCP-compatible AI assistants to your Directories.ai account.

Quick Setup Guide

Get started in 3 simple steps

1

Get your API key

Navigate to Dashboard → Settings → API Keys and generate a new key

2

Choose your AI client below

Copy the configuration for Claude Desktop or Cursor

3

Paste and restart

Add the config to your client's MCP settings file and restart the application

Claude Desktop Configuration

Add this to your Claude Desktop MCP configuration file

Configuration File Location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Configuration JSON:

{
  "mcpServers": {
    "directories-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@directories-ai/mcp-server"
      ],
      "env": {
        "DIRECTORIES_AI_API_KEY": "your_api_key_here"
      }
    }
  }
}

⚠️ Don't forget to replace the API key!

Replace your_api_key_here with your actual API key from the dashboard.

After adding the configuration:

  1. Save the file
  2. Completely quit Claude Desktop (don't just close the window)
  3. Restart Claude Desktop
  4. The Directories.ai MCP server will be available in your conversations
Claude MCP Documentation

Available MCP Commands

Once connected, you can use these commands in your AI conversations

List Directories

Get all your directories

mcp://directories-ai/list-directories

Get Directory Details

Fetch information about a specific directory

mcp://directories-ai/get-directory?id=DIRECTORY_ID

List Listings

Get all listings in a directory

mcp://directories-ai/list-listings?directory_id=DIRECTORY_ID

Create Listing

Add a new listing to a directory

mcp://directories-ai/create-listing

AI Agent Operations

Interact with your AI agents

mcp://directories-ai/ai-agents/*

Troubleshooting

MCP server not showing up?

  • Make sure you completely quit and restarted the application
  • Check that the config file is valid JSON (no trailing commas)
  • Verify your API key is correct
  • Check the application's logs for error messages

API key not working?

  • Ensure the API key is active in your dashboard
  • Check that it hasn't expired
  • Verify there are no extra spaces or characters

Need more help?

Contact our support team at support or check our full documentation.