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 `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

.

├── 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 support@pro.makeup
• Security issues: email support@pro.makeup 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 support@pro.makeup.