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).
| Tool | Scope | Read-only? |
|---|
promakeup_search_pros | open | ā
|
promakeup_get_business_by_slug | open | ā
|
promakeup_get_business_by_phone | owner:read | ā
|
promakeup_get_business | open | ā
|
promakeup_list_services_nearby | open | ā
|
promakeup_list_schools | open | ā
|
promakeup_get_discovery_summary | open | ā
|
promakeup_emit_listing_event | listing-events:write | ā |
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.