# Teres

> Verified, structured business data for AI agents — services, pricing, hours, staff, and FAQs.

Teres is an AI-readable business directory. Every business profile contains verified, up-to-date data that AI assistants can use to accurately answer questions about local businesses.

## Business Profiles

Every business has a human-readable page and a machine-readable JSON endpoint:

- Profile page: https://teres.io/biz/{slug}
- JSON data: https://teres.io/biz/{slug}.json
- Sitemap: https://teres.io/sitemap.xml

Append .json to any business profile URL to get structured data.

## REST API

Base URL: https://api.teres.io

### Search businesses
GET /v1/businesses/search?query=barber&location=Austin,TX

### Get business info
GET /v1/businesses/:id

### Get services
GET /v1/businesses/:id/services

## MCP Server

Endpoint: https://api.teres.io/mcp
Transport: Streamable HTTP
Protocol: MCP 2025-03-26

### Available tools
- search_businesses: Search for businesses by query, location, service type, attributes
- get_business_info: Get full business details including hours, FAQs, staff, photos
- list_services: Get service menu with prices and durations
- get_availability: Check real-time appointment availability
- create_booking: Book an appointment
- get_booking: Look up a booking by confirmation code
- cancel_booking: Cancel a booking
- reschedule_booking: Reschedule a booking
- submit_review: Leave a review after a booking
- get_reviews: Read reviews for a business

### Connect via MCP
```json
{
  "mcpServers": {
    "teres": {
      "url": "https://api.teres.io/mcp"
    }
  }
}
```

## Embed

Businesses add structured JSON-LD data to their websites via Teres:
GET /v1/embed/location/:locationId

## JSON Response Format

The .json endpoint returns:

```json
{
  "business": { "name", "slug", "description", "website" },
  "location": { "address", "city", "state", "zip", "phone" },
  "types": ["Barber Shop"],
  "services": [{ "name", "category", "priceCents", "priceType", "durationMinutes" }],
  "staff": [{ "name", "title", "specialties" }],
  "faqs": [{ "question", "answer" }],
  "hours": { "monday": { "open": "09:00", "close": "18:00" }, ... },
  "photos": ["https://..."]
}
```

## Links

- Website: https://teres.io
- Business dashboard: https://app.teres.io