pro.makeup

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 claude_desktop_config.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: find_makeup_pro, compare_pros, book_appointment_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 [email protected] 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

.├── README.md                — this file├── LICENSE                  — MIT├── server.json              — MCP registry (registry.modelcontextprotocol.io) submission├── smithery.yaml            — Smithery.ai integration manifest├── spec/│   ├── server-card.json     — SEP-1649 MCP server card│   ├── agent-card.json      — A2A protocol descriptor│   ├── openapi.json         — OpenAPI 3.1 spec for the underlying HTTP API│   ├── auth.md              — Bearer-token authentication model│   ├── agents.md            — agent-oriented integration guide│   ├── llms.txt             — llms.txt manifest (short)│   └── llms-full.txt        — llms-full.txt reference (comprehensive)├── examples/│   ├── claude-desktop.json  — Claude Desktop MCP config│   ├── cursor.json          — Cursor MCP config│   ├── vscode.json          — VS Code (mcp-aware extensions) config│   ├── curl-quickstart.sh   — bash smoke tests│   └── typescript-client.ts — minimal TypeScript client over JSON-RPC└── docs/    ├── architecture.md      — design of the hosted MCP server    └── registry-submission.md — registry submission tracker

Listings

This MCP server is registered in:

Reporting issues / requesting changes

• Bug or behavioral issue with a tool: open a GitHub issue
• Inaccuracy on a specific business listing: report via the listing's "Report this listing" link on pro.makeup, or email [email protected]
• Security issues: email [email protected] directly (do not file a public issue)

License

MIT — see LICENSE. The pro.makeup directory data itself is © PRO Makeup / Evergrow Management PTE LTD; the data's usage policy is declared in the site's robots.txt via the Content-Signal directive (search=yes, ai-train=yes, ai-input=yes).

Operator

Operated by Evergrow Management PTE LTD. Contact [email protected].