Koskamo

Agent Salon SF MCP

An MCP server providing structured data on 910 San Francisco hair salons, enabling AI agents to search for salons, compare service options against budgets, check candidate availability, and retrieve merchant details with source-backed evidence for decision-making.

Visit Agent Salon SF

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Agent Salon SF MCP logo, by Agent Salon SFVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by Agent Salon SF
MCP endpoint (Streamable HTTP)
https://agentsalonsf.com/mcp
Vendor documentation

What you can do with it

  • Compare salon service options against a specific budget and date
  • Search for salons by name, neighborhood, or service type
  • Retrieve detailed merchant profiles and published pricing
  • Check candidate availability and get booking links

Source and maintenance

Vendor evidenceRegistry 1.0.0
mcp-registry: com.agentsalonsf/salon-decisions@1.0.0Project website

Protocol and capabilities

Server
agentsalonsf 1.6.0
MCP protocol
2025-06-18
Tools
11 advertised
Resources
1 advertised
Resource templates
0 advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  },
  "resources": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Agent Salon SF: San Francisco haircuts, structured for AI agents. Independent; not affiliated with any salon listed; booking happens on the salon's own system. Dataset snapshot 2026-10-25; per-fact check dates may differ; dataset b-merchants@2026-10-23T11:05:07Z#4f15ef234749;price-kinds@2026-10-24T09:56:47Z+public-research@e360e97d86a8+handoffs@eeeb1675e507. Start with compare_options when choosing a supported service with a budget, selected extras or a date: it returns known subtotals, unresolved charges, conditions and next actions. Read options, uncertain and excluded, and continue with next_offset before concluding no matches. Date-specific choices are conditional. Time-of-day, stylist and hair-length requirements must be retained for merchant confirmation; compare_options does not filter them. search_merchants is for name/address discovery; check_availability supplies one salon's published hours, not live slots or an extras-inclusive quote; search_haircuts matches haircut offerings by type, price, stylist and time window (profiled salons hand-normalized; listed salons inferred from service names, offering.comparable says when apples-to-apples). Every salon has depth: profiled (booking-system depth), detailed (published menu, booking link and business hours or durations), or listed (public listing facts). Unknown facts are null. Quote status tags and dates when relaying facts. Start times are candidate start times from the salon's published staff schedule; existing bookings are not subtracted, so some may already be taken — confirm on the booking page; never present them as confirmed openings (availability_basis "schedule_candidates" = unconfirmed; "published_hours" = opening hours only). No Google or Yelp content is published.

Tools

11 advertised

compare_options — Compare a service with budget, extras and date
Advertised by the server during the last successful anonymous check.
Advertised read-only

START HERE for choosing a service under a budget, with extras, or on a date. Use search_merchants for name/address lookup; use this tool for the service decision. Compare a supported service intent, optional budget/date/neighborhood, strict or nearby geography, and selected add-ons (blow_dry, haircut, toner, shampoo, deep_conditioning, iron_finish, extensions). Returns options, uncertain and excluded service decisions plus separately paginated unresolved_salons when no matching service is established. next_action.booking_url is the direct merchant destination, with link scope and check status. Returns service decisions with per-fact sources/dates, known subtotal including requested/mandatory extras, unresolved charges, explicit conditions, hours conflicts and exact next actions. Starting prices and required consultations never become guaranteed final quotes. Deposit is advance payment, not an added charge. There is no provider-confirmed availability; date-specific results are conditional. Time-of-day, stylist and hair-length requirements are unsupported filters here; retain them for merchant confirmation. Ordering is geographic/alphabetic, not a quality rating. No booking or hold is created. Paginated: limit <= 50, offset; use next_offset across all three result groups.

compare_options input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "service_intent"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Valid YYYY-MM-DD in America/Los_Angeles; not a confirmed appointment"
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Total entries across options/uncertain/excluded; continue with next_offset"
    },
    "salon": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1,
      "description": "Optional salon slug or ref from search results to compare only that salon."
    },
    "budget": {
      "type": "number",
      "minimum": 0,
      "description": "USD cap for the requested service and selected/mandatory extras. A lower bound is not proof the full price fits."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "geography": {
      "enum": [
        "strict",
        "nearby"
      ],
      "type": "string",
      "default": "strict",
      "description": "strict by default; nearby requires a neighborhood and explicit permission to include nearby salons."
    },
    "neighborhood": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
    },
    "service_intent": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "color, balayage, balayage color, creative color, color consultation, highlights, haircut, mens haircut, womens haircut, wash cut style, or blowout; unsupported intents are errors"
    },
    "selected_addons": {
      "type": "array",
      "items": {
        "enum": [
          "blow_dry",
          "haircut",
          "toner",
          "shampoo",
          "deep_conditioning",
          "iron_finish",
          "extensions"
        ],
        "type": "string"
      },
      "maxItems": 7,
      "description": "Only extras the user requested. Mandatory extras are added automatically; unknown charges are not free."
    },
    "require_availability": {
      "type": "boolean",
      "description": "Require provider-confirmed availability. None exists today; opening hours and candidate times cannot satisfy this."
    }
  },
  "additionalProperties": false
}
compare_options annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}
search_merchants — Search salons
Advertised by the server during the last successful anonymous check.
Advertised read-only

Filter collection=public-research for researched menus, add-ons, public stylist information and policies. Call get_merchant for the full public_research object. Discovery and name/address lookup, not an extras-inclusive price decision. For a supported service with budget, extras or date, start with compare_options. Find San Francisco hair salons and barbers by name/street (q), neighborhood (with nearby), service, date/time and online booking. Returns compact task summaries by default: depth (profiled = researched in depth; listed = public records + the business’s own site, see depth_note), booking_cta, hours_for_day (published hours for `date`, not live slots), up to 3 matched_offerings with prices, license_status, freshness, availability_basis (published_hours / schedule_candidates = unconfirmed / none); profiled salons add candidate_start_times. Unknown values are null. For published hours/detail only, call check_availability. Before selecting a budget option, call compare_options; follow next_action to confirm unresolved charges and actual appointment availability with the merchant.

search_merchants input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "q": {
      "type": "string",
      "description": "Business name or street, fuzzy (e.g. \"cinta\", \"hairshaper\", \"23 grant\")"
    },
    "day": {
      "type": "string",
      "description": "Open on this day per published hours: Mo..Su or e.g. \"saturday\""
    },
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD in the city’s timezone (default today): hours_for_day is computed for this date"
    },
    "view": {
      "enum": [
        "summary",
        "full"
      ],
      "type": "string",
      "description": "summary = compact task view (default); full = every field"
    },
    "after": {
      "type": "string",
      "description": "HH:MM earliest start (with date); applied to start times only under require_availability"
    },
    "depth": {
      "enum": [
        "profiled",
        "detailed",
        "listed"
      ],
      "type": "string",
      "description": "Only salons of this depth: profiled (booking-system depth), detailed (priced menu + booking link + hours or durations), listed (the rest)"
    },
    "limit": {
      "type": "integer",
      "maximum": 25,
      "minimum": 1,
      "description": "Default 10, max 25"
    },
    "before": {
      "type": "string",
      "description": "HH:MM latest start (with date); applied to start times only under require_availability"
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "service": {
      "type": "string",
      "description": "Service tag (e.g. \"balayage\"), intent slug (e.g. \"hair-color\", \"open-saturday\", \"mens-haircut\") or free text"
    },
    "stylist": {
      "type": "string",
      "description": "Stylist display name (profiled salons)"
    },
    "max_price": {
      "type": "number",
      "description": "Base offering price in USD, not the complete service with extras; use compare_options for that. Only offerings whose price is KNOWN to be at most this (fixed or bounded range); starting prices do not count",
      "exclusiveMinimum": 0
    },
    "specialty": {
      "type": "string"
    },
    "collection": {
      "type": "string",
      "const": "public-research",
      "description": "Only independently researched public-source profiles; missing fields are UNKNOWN; booking stays on salon website"
    },
    "open_after": {
      "type": "string",
      "description": "Closes after HH:MM (on `day` if given)"
    },
    "time_after": {
      "type": "string",
      "description": "HH:MM — with date: only intervals open after this time count"
    },
    "hair_length": {
      "enum": [
        "short",
        "medium",
        "long",
        "any"
      ],
      "type": "string"
    },
    "has_booking": {
      "type": "boolean",
      "description": "Only salons with (true) / without (false) an online booking link"
    },
    "time_before": {
      "type": "string",
      "description": "HH:MM — with date: only intervals open before this time count"
    },
    "haircut_type": {
      "enum": [
        "cut",
        "cut_wash",
        "cut_wash_style",
        "buzz",
        "beard_trim",
        "blow_dry",
        "other"
      ],
      "type": "string",
      "description": "Only salons with an offering of this normalized haircut type (profiled salons)"
    },
    "neighborhood": {
      "type": "string",
      "description": "Neighborhood slug, label or alias (e.g. \"soma\", \"mission\") or an area (e.g. \"union-square\")"
    },
    "open_on_date": {
      "type": "boolean",
      "description": "Only salons open on `date` per published hours (not live slots)"
    },
    "include_nearby": {
      "type": "boolean",
      "description": "With neighborhood: also include salons within ~400 m (match=\"nearby\", distance_label). Default true."
    },
    "require_availability": {
      "type": "boolean",
      "description": "Only offerings with PROVIDER-CONFIRMED start times in the date/after/before window. Schedule-derived candidate start times never satisfy it; salons that have only candidates are returned under `unconfirmed` with unconfirmed_reason. No salon has provider-confirmed availability today."
    }
  }
}
search_merchants annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}
check_availability — Check hours, prices and how to book for one salon
Advertised by the server during the last successful anonymous check.
Advertised read-only

Published facts for one salon, NOT live availability and NOT an extras-inclusive quote. For a service/budget/extras/date decision use compare_options with salon=ref. For one salon (ref from search_merchants) and a date: published opening hours on that date (open/closed — NOT live appointment slots), offerings matching the service with published prices and durations, the booking link and step-by-step booking instructions. Profiled salons add candidate start times (candidate start times from the salon's published staff schedule; existing bookings are not subtracted, so some may already be taken — confirm on the booking page). Same contract as GET /api/v1/availability?ref=.

check_availability input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ref"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "\"<city>/<vertical>/<slug>\""
    },
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD (default today in the city’s timezone)"
    },
    "service": {
      "type": "string",
      "description": "e.g. \"balayage\", \"mens-haircut\" or free text"
    },
    "time_after": {
      "type": "string"
    },
    "time_before": {
      "type": "string"
    }
  }
}
check_availability annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}
get_merchant — Get one salon
Advertised by the server during the last successful anonymous check.
Advertised read-only

All published facts for one salon by ref "<city>/<vertical>/<slug>" (from search results), with crawl_log (every source fetched or checked, with time, result and the facts it gave) and last_verified_at: address, phone, hours, licence, registry, services with published prices, booking link, per-field sources (verification), what we verified and what we did not.

get_merchant input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ref"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "e.g. \"san-francisco/hair-salon/hairshaper\""
    }
  }
}
get_merchant annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}
list_salons — List salons
Advertised by the server during the last successful anonymous check.

Use collection=public-research for public-source profiles with menus, add-ons, stylist information and policies; get_merchant returns the full public_research object. Salons covered (San Francisco), ordered profiled, detailed, then listed, with depth, neighborhood, price floor and range, stylist count, availability basis and freshness, last_verified_at and verification date. Paginated: limit (default 50, max 200), offset, depth=profiled|detailed|listed.

list_salons input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "depth": {
      "enum": [
        "profiled",
        "detailed",
        "listed"
      ],
      "type": "string",
      "description": "profiled = booking-system depth; detailed = priced menu + booking link + hours or durations; listed = the rest"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "collection": {
      "type": "string",
      "const": "public-research"
    }
  }
}
search_haircuts — Search haircuts by constraints
Advertised by the server during the last successful anonymous check.

Base offering lookup by haircut type, length or stylist. Use compare_options for a supported service with budget, extras or date; preserve any unsupported stylist/length/time requirements for merchant confirmation. Find haircut offerings (and optionally stylists and candidate start times) that satisfy ALL given constraints, across profiled salons (hand-normalized menus) and listed salons (type and inclusions inferred from the service name; offering.comparable says whether it can be compared apples-to-apples). Start times are candidate start times from the salon's published staff schedule; existing bookings are not subtracted, so some may already be taken — confirm on the booking page (slotBasis "schedule_candidates", bookingsSubtracted false, availability_basis "schedule_candidates" = UNCONFIRMED). require_availability=true is satisfied only by provider-confirmed availability (the booking provider’s own open times, existing bookings subtracted). No salon on this site has provider-confirmed availability today: profiled salons have candidate start times from the published staff schedule (existing bookings not subtracted, so they may already be taken) and listed salons have published opening hours only. Offerings with matching candidate start times are listed under `unconfirmed`; confirm on the booking page. Hard constraints are never relaxed silently; when nothing matches, noMatch.reason explains which constraint blocked and nearest suggests the smallest change. Prices are published menu or online-booking prices in USD; this search does not add requested or mandatory extras. Times are salon-local (America/Los_Angeles).

search_haircuts input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 100
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "after": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}$"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1
    },
    "before": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}$"
    },
    "stylist": {
      "type": "string",
      "maxLength": 80
    },
    "max_price": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "specialty": {
      "type": "string",
      "maxLength": 60
    },
    "hair_length": {
      "enum": [
        "short",
        "medium",
        "long",
        "any"
      ],
      "type": "string"
    },
    "haircut_type": {
      "enum": [
        "cut",
        "cut_wash",
        "cut_wash_style",
        "buzz",
        "beard_trim",
        "blow_dry",
        "other"
      ],
      "type": "string"
    },
    "neighborhood": {
      "type": "string",
      "maxLength": 80
    },
    "require_availability": {
      "type": "boolean",
      "default": false
    }
  }
}
get_salon — Get salon
Advertised by the server during the last successful anonymous check.

Full record for one salon as markdown: facts, hours, every haircut service with price/duration/inclusions, stylists, policies, attributes, evidence, booking rules, candidate start times from the published schedule. Every fact carries a status tag and date.

get_salon input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Salon slug, e.g. \"hairshaper\""
    },
    "format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "default": "markdown"
    }
  }
}
get_stylist — Get stylist
Advertised by the server during the last successful anonymous check.

One stylist, under the name the salon's booking system shows: salon, bookable status, specialty evidence with sources, services and prices, candidate start times from the published schedule, and booking link.

get_stylist input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Stylist slug, e.g. \"hairshaper-shirley\", or a display name like \"Shirley\""
    },
    "format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "default": "markdown"
    }
  }
}
get_availability — Get availability
Advertised by the server during the last successful anonymous check.

NOT live availability. Use compare_options for budget/extras/date decisions. Candidate start times for one offering at one salon, optionally one stylist and a date/time window: candidate start times from the salon's published staff schedule; existing bookings are not subtracted, so some may already be taken — confirm on the booking page. Results carry slotBasis "schedule_candidates" and bookingsSubtracted false; freshness tells you how old the capture is.

get_availability input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "salon",
    "offering"
  ],
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Salon-local date"
    },
    "after": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}$"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1
    },
    "salon": {
      "type": "string"
    },
    "before": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}$"
    },
    "stylist": {
      "type": "string"
    },
    "offering": {
      "type": "string",
      "description": "Offering id or slug from get_salon"
    }
  }
}
get_booking_link — Get booking link
Advertised by the server during the last successful anonymous check.

The salon's own booking URL plus exact remaining steps for a given service, stylist, and start time. This site never books on the user's behalf; precision says how much the link pre-selects.

get_booking_link input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "salon"
  ],
  "properties": {
    "salon": {
      "type": "string"
    },
    "start": {
      "type": "string",
      "description": "ISO start time from get_availability"
    },
    "stylist": {
      "type": "string"
    },
    "offering": {
      "type": "string"
    }
  }
}
get_guide — Read a source-backed salon guide
Advertised by the server during the last successful anonymous check.
Advertised read-only

A build-time guide snapshot: answer, evidence rows, metrics, source dates and limits. Slugs are listed at /api/v1/guides. No live prices or availability are implied.

get_guide input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1
    }
  }
}
get_guide annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

Prompts

Not advertised

No prompt definitions available.

Resources

1 advertised

llms-txt — Site index (llms.txt)

Advertised by the server during the last successful anonymous check.

llms-txt URI
https://agentsalonsf.com/llms.txt

MIME type: text/plain

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
1031 ms
95th percentile latency
1031 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 1031 ms · metadata changed · 11 tool(s), 1 resource(s), 0 resource template(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http agent-salon-sf-mcp https://agentsalonsf.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add agent-salon-sf-mcp --url https://agentsalonsf.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable agent-salon-sf-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "agent-salon-sf-mcp": {
      "url": "https://agentsalonsf.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "agent-salon-sf-mcp": {
      "type": "streamableHttp",
      "url": "https://agentsalonsf.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start agent-salon-sf-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "agent-salon-sf-mcp": {
      "type": "http",
      "url": "https://agentsalonsf.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http agent-salon-sf-mcp https://agentsalonsf.com/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "agent-salon-sf-mcp": {
      "url": "https://agentsalonsf.com/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "agent-salon-sf-mcp": {
      "serverUrl": "https://agentsalonsf.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Agent Salon SF MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 3,947

Do you run Agent Salon SF MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing