# AnchorList — Complete AI Agent Reference

> The AI agent directory for local businesses. A structured data layer that makes local service providers discoverable, queryable, and bookable by any AI assistant.

## Overview

AnchorList is the Yellow Pages for the agentic economy. We maintain a verified directory of local businesses across the United States, exposed through a clean REST API and MCP (Model Context Protocol) server. Any AI assistant — Claude, ChatGPT, Gemini, or custom agents — can use AnchorList to help users find and book local services.

## Service Categories

AnchorList covers the following top-level categories, each with multiple subcategories:

### Legal Services
- Family Law, Corporate Law, Criminal Defense, Immigration, Real Estate Law, Estate Planning, Personal Injury, Intellectual Property

### Real Estate
- Residential Sales, Commercial Real Estate, Property Management, Appraisals, Home Inspections, Title & Escrow

### Healthcare & Wellness
- Primary Care, Dental, Dermatology, Mental Health, Physical Therapy, Chiropractic, Med Spa, Optometry

### Home Services
- HVAC, Plumbing, Electrical, General Contracting, Roofing, Landscaping, Pest Control, Cleaning, Painting

### Financial Services
- Tax Preparation, Bookkeeping, Financial Planning, Insurance, Mortgage Lending, Business Consulting

### Personal Care
- Hair Salons, Barbershops, Nail Salons, Day Spas, Tattoo Studios, Personal Training

### Architecture & Design
- Residential Architecture, Commercial Architecture, Interior Design, Landscape Architecture

## REST API Reference

Base URL: https://api.anchorlist.ai

### Search Businesses
POST /api/v1/search

Request body:
{
  "intent": "string (required) — Natural language description of what the user needs, e.g. 'I need an immigration lawyer in Miami' or 'emergency plumber near me'",
  "location": "string (optional) — City, state, or zip code",
  "category": "string (optional) — Service category filter",
  "urgency": "string (optional) — One of: routine, urgent, emergency. Default: routine",
  "limit": "integer (optional) — Max results. Default: 3"
}

Response:
{
  "success": true,
  "count": 3,
  "results": [
    {
      "id": "string",
      "name": "string",
      "category": "string",
      "subcategory": "string",
      "rating": 4.8,
      "reviewCount": 124,
      "location": {
        "city": "string",
        "state": "string",
        "address": "string",
        "zipCode": "string"
      },
      "phone": "string",
      "website": "string",
      "services": [{ "name": "string", "description": "string", "basePrice": 0 }],
      "pricing": {
        "currency": "USD",
        "estimateType": "fixed|hourly|per_unit",
        "minPrice": 0,
        "maxPrice": 0
      },
      "yearsInBusiness": 18,
      "licensed": true,
      "insured": true,
      "certifications": ["string"],
      "responseTime": "within 2 hours",
      "description": "string"
    }
  ]
}

### List Categories
GET /api/v1/categories?limit=100

Response:
{
  "success": true,
  "count": 8,
  "categories": [
    { "id": "string", "name": "string", "subcategories": ["string"] }
  ]
}

### Get Business Profile
GET /api/v1/businesses/{id}

Response:
{
  "success": true,
  "business": { ...full business object as shown in search results }
}

### Check Availability
GET /api/v1/businesses/{id}/availability

Response:
{
  "success": true,
  "businessId": "string",
  "businessName": "string",
  "availability": [
    {
      "date": "2026-03-30",
      "slots": [
        { "start": "08:00", "end": "10:00", "available": true },
        { "start": "10:00", "end": "12:00", "available": false }
      ]
    }
  ]
}

### Book Appointment
POST /api/v1/bookings

Request body:
{
  "businessId": "string (required)",
  "date": "string (required) — YYYY-MM-DD format",
  "time": "string (required) — HH:MM format",
  "customerName": "string (required)",
  "customerPhone": "string (required)",
  "serviceType": "string (required)",
  "notes": "string (optional)"
}

Response:
{
  "success": true,
  "confirmationNumber": "AL-1704067200000-ABC123XYZ",
  "message": "Appointment booked successfully",
  "details": {
    "businessId": "string",
    "businessName": "string",
    "date": "string",
    "time": "string",
    "serviceType": "string",
    "customerName": "string"
  }
}

## MCP Integration

AnchorList provides a Model Context Protocol (MCP) server for direct integration with AI assistants that support MCP.

### Installation
npm install -g @anchorlist/mcp-server

### Configuration (Claude Desktop)
Add to claude_desktop_config.json:
{
  "mcpServers": {
    "anchorlist": {
      "command": "npx",
      "args": ["-y", "@anchorlist/mcp-server"]
    }
  }
}

### MCP Tools Available
1. anchorlist_find_business — Search for businesses by intent, location, category, urgency
2. anchorlist_check_availability — Check availability for a specific business on a date
3. anchorlist_book — Book an appointment with a business
4. anchorlist_list_categories — List all available service categories
5. anchorlist_get_openapi_spec — Get the full OpenAPI specification

### Remote MCP Endpoint
For platforms supporting remote MCP: https://api.anchorlist.ai/mcp

## Typical Agent Workflow

1. User says: "I need a real estate attorney in Chicago"
2. Agent calls POST /api/v1/search with intent="real estate attorney" and location="Chicago, IL"
3. Agent receives ranked results with ratings, pricing, and availability
4. User picks a business
5. Agent calls GET /api/v1/businesses/{id}/availability to show open slots
6. User selects a time slot
7. Agent calls POST /api/v1/bookings to confirm the appointment
8. User receives confirmation number

## Discovery Endpoints

- Website: https://anchorlist.ai
- API: https://api.anchorlist.ai
- MCP Discovery: https://anchorlist.ai/.well-known/mcp.json
- Agent Card (A2A): https://anchorlist.ai/.well-known/agent.json
- OpenAPI Spec: https://api.anchorlist.ai/api/v1/openapi.json
- LLM Summary: https://anchorlist.ai/llms.txt
- Documentation: https://docs.anchorlist.ai

## Contact

- Website: https://anchorlist.ai
- API Support: api@anchorlist.ai
- Region: United States