pro.makeup MCP server

pro.makeup MCP server

Hosted Model Context Protocol server for the pro.makeup directory — 214,000+ certified makeup professionals (artists, salons, schools, shops, and brands) across 100+ countries.

This repository is the public specification and integration kit for the hosted MCP server at https://pro.makeup/api/mcp. The server itself is operated by PRO Makeup / Evergrow Management PTE LTD; this repo collects the server card, OpenAPI spec, example client configurations, registry submission metadata, and architectural documentation.

If you are building an agent that needs to find a makeup professional, school, or shop — point your MCP-aware client at the URL above and you're done.

Quick start

Claude Desktop / Claude Code

Add to your claudedesktopconfig.json (Claude Desktop) or per-project .mcp.json (Claude Code):

{
  "mcpServers": {
    "promakeup": {
      "type": "streamable-http",
      "url": "https://pro.makeup/api/mcp"
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "promakeup": {
      "url": "https://pro.makeup/api/mcp"
    }
  }
}

Raw HTTP (curl)

curl -s -X POST https://pro.makeup/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

See examples/ for additional configurations.

What it exposes

8 tools, 3 prompts, 2 templated resources. All read tools require no authentication; the two phone-related / write tools require a scoped Bearer token (see spec/auth.md).

Prompts: findmakeuppro, comparepros, bookappointment_intent.

Resources: promakeup://business/{slug}, promakeup://category/{category}/featured.

Full tool descriptions, input schemas, and example outputs are in spec/server-card.json and spec/openapi.json.

Auth

Tokens are issued out-of-band by the operator. Email support@pro.makeup with:

• The integration name and use case
• The scopes you need (the smallest subset that works)
• The expected request volume

Full token format, lifecycle, and error responses in spec/auth.md.

Repository layout

Shortened. The full README is on GitHub.