Model Context Protocol

MCP Integration

Connect AI agents to our verified business directory using the Model Context Protocol. Safe, structured access to trusted business data.

Verified Data Only
Public MCP access only returns approved and published listings with verified information.
Role-Based Access
Different capabilities for public, authenticated, and admin agents with proper authorization.
Structured Responses
All responses are strongly typed JSON with consistent schemas for reliable agent consumption.
Available Resources
URI-addressable resources that agents can read from the directory
business://{id}public

Get a business by its unique identifier

Example: business://biz_abc123

business://slug/{slug}public

Get a business by its URL-friendly slug

Example: business://slug/acme-technology-solutions

category://{slug}public

Get all businesses in a category

Example: category://technology

directory://search?query=...public

Search the directory with filters

Example: directory://search?query=ai+startup&location=san-francisco

Example Tool Response
Response from get_business tool with _meta envelope
{
  "business": {
    "id": "biz_abc123",
    "slug": "acme-technology-solutions",
    "name": "Acme Technology Solutions",
    "description": "Enterprise software consulting...",
    "categories": ["Technology", "Consulting"],
    "tags": ["saas", "enterprise", "ai"],
    "contact": {
      "website": "https://acme.tech",
      "phone": "+1 (555) 123-4567",
      "email": "hello@acme.tech"
    },
    "location": {
      "city": "San Francisco",
      "state": "CA",
      "country": "US"
    }
  },
  "_meta": {
    "source": "verified_directory",
    "verified": true,
    "trust_score": 92,
    "published_at": "2024-01-15T10:00:00Z",
    "last_verified_at": "2024-02-20T14:30:00Z"
  }
}

The _meta envelope tells AI agents they're receiving trusted, moderated data — not raw scraped content. This is the key differentiator for reliable AI consumption.

Ready to integrate?

View our full API documentation for implementation details and authentication setup.