MCP Integration

AI-Native Directory Access

Connect AI agents to verified business data using the Model Context Protocol. Safe, structured, and permission-aware.

What is MCP?

The Model Context Protocol (MCP) is an open standard for connecting AI systems to external data sources and tools. It enables AI agents to safely access real-time, verified business data from our directory through standardized resources and tools.

Resources

URI-based access to business entities and collections

Tools

Callable functions for search, retrieval, and management

Safety

Role-based access ensures AI only sees appropriate data

MCP Resources
URI-based resource access for AI agents
business://{id}

Business by ID

Public

Retrieve a verified business by its unique identifier

Example:business://biz_01h8x9y2z3
business://slug/{slug}

Business by Slug

Public

Retrieve a business by its URL-friendly slug

Example:business://slug/acme-technologies
category://{slug}

Category

Public

Get category details and associated businesses

Example:category://technology
directory://search?query=...

Directory Search

Public

Search the entire directory with filters

Example:directory://search?query=software&location=sf
MCP Tools
Callable tools for AI agents to interact with the directory

Safe for Public AI Access

These tools only return approved, published businesses. No internal data, admin notes, or private information is exposed.

search_businesses

Search verified businesses by keyword, category, or location

Public

Inputs:

query: stringcategory: stringcity: stringstate: stringverified_only: booleanlimit: number
get_business

Get detailed information about a specific business

Public

Inputs:

id: string*
get_business_by_slug

Get a business by its URL slug

Public

Inputs:

slug: string*
list_categories

List all available business categories

Public
get_businesses_by_location

Find businesses in a specific geographic area

Public

Inputs:

city: stringstate: stringradius_miles: number
Example Tool Response
Response from search_businesses tool
{
  "tool": "search_businesses",
  "result": {
    "businesses": [
      {
        "id": "biz_01h8x9y2z3",
        "display_name": "Acme Technologies",
        "description_short": "Leading provider of innovative tech solutions",
        "categories": [
          "Technology",
          "Software"
        ],
        "city": "San Francisco",
        "state": "CA",
        "verification_status": "verified",
        "ai_summary": "Acme Technologies is a leading software company specializing in AI-powered business tools."
      }
    ],
    "total": 1,
    "has_more": false
  }
}
Safety Guarantees
What MCP clients can trust
Only verified, published businesses returned
Role-aware access control enforced
No internal notes or private data exposed
Structured JSON for reliable parsing
AI summaries and keywords included
Verification status always visible
Server Configuration
MCP server connection details
mcp://directory.verifieddirectory.com
2024-01-01

Connect Your AI Agent

Start building AI-powered applications with access to verified business data.