{
  "markdown": "# pro.makeup MCP server\n\nHosted [Model Context Protocol](https://modelcontextprotocol.io) server for the\n**pro.makeup** directory — 214,000+ certified makeup professionals (artists,\nsalons, schools, shops, and brands) across 100+ countries.\n\nThis repository is the **public specification and integration kit** for the\nhosted MCP server at `https://pro.makeup/api/mcp`. The server itself is\noperated by PRO Makeup / Evergrow Management PTE LTD; this repo collects the\nserver card, OpenAPI spec, example client configurations, registry submission\nmetadata, and architectural documentation.\n\nIf you are building an agent that needs to find a makeup professional, school,\nor shop — point your MCP-aware client at the URL above and you're done.\n\n---\n\n## Quick start\n\n### Claude Desktop / Claude Code\n\nAdd to your `claude_desktop_config.json` (Claude Desktop) or per-project\n`.mcp.json` (Claude Code):\n\n```json\n{\n  \"mcpServers\": {\n    \"promakeup\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://pro.makeup/api/mcp\"\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"promakeup\": {\n      \"url\": \"https://pro.makeup/api/mcp\"\n    }\n  }\n}\n```\n\n### Raw HTTP (`curl`)\n\n```bash\ncurl -s -X POST https://pro.makeup/api/mcp \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'\n```\n\nSee [`examples/`](./examples/) for additional configurations.\n\n---\n\n## What it exposes\n\n8 tools, 3 prompts, 2 templated resources. All read tools require no\nauthentication; the two phone-related / write tools require a scoped Bearer\ntoken (see [`spec/auth.md`](./spec/auth.md)).\n\n| Tool                                  | Scope                  | Read-only? |\n|---------------------------------------|------------------------|:----------:|\n| `promakeup_search_pros`               | open                   | ✅          |\n| `promakeup_get_business_by_slug`      | open                   | ✅          |\n| `promakeup_get_business_by_phone`     | `owner:read`           | ✅          |\n| `promakeup_get_business`              | open                   | ✅          |\n| `promakeup_list_services_nearby`      | open                   | ✅          |\n| `promakeup_list_schools`              | open                   | ✅          |\n| `promakeup_get_discovery_summary`     | open                   | ✅          |\n| `promakeup_emit_listing_event`        | `listing-events:write` | ❌          |\n\nPrompts: `find_makeup_pro`, `compare_pros`, `book_appointment_intent`.\n\nResources: `promakeup://business/{slug}`, `promakeup://category/{category}/featured`.\n\nFull tool descriptions, input schemas, and example outputs are in\n[`spec/server-card.json`](./spec/server-card.json) and\n[`spec/openapi.json`](./spec/openapi.json).\n\n---\n\n## Auth\n\nTokens are issued out-of-band by the operator. Email\n**`support@pro.makeup`** with:\n\n- The integration name and use case\n- The scopes you need (the smallest subset that works)\n- The expected request volume\n\nFull token format, lifecycle, and error responses in\n[`spec/auth.md`](./spec/auth.md).\n\n---\n\n## Repository layout\n\n```\n.\n├── README.md                — this file\n├── LICENSE                  — MIT\n├── server.json              — MCP registry (registry.modelcontextprotocol.io) submission\n├── smithery.yaml            — Smithery.ai integration manifest\n├── spec/\n│   ├── server-card.json     — SEP-1649 MCP server card\n│   ├── agent-card.json      — A2A protocol descriptor\n│   ├── openapi.json         — OpenAPI 3.1 spec for the underlying HTTP API\n│   ├── auth.md              — Bearer-token authentication model\n│   ├── agents.md            — agent-oriented integration guide\n│   ├── llms.txt             — llms.txt manifest (short)\n│   └── llms-full.txt        — llms-full.txt reference (comprehensive)\n├── examples/\n│   ├── claude-desktop.json  — Claude Desktop MCP config\n│   ├── cursor.json          — Cursor MCP config\n│   ├── vscode.json          — VS Code (mcp-aware extensions) config\n│   ├── curl-quickstart.sh   — bash smoke tests\n│   └── typescript-client.ts — minimal TypeScript client over JSON-RPC\n└── docs/\n    ├── architecture.md      — design of the hosted MCP server\n    └── registry-submission.md — registry submission tracker\n```\n\n---\n\n## Listings\n\nThis MCP server is registered in:\n\n| Registry | Status | Link |\n|---|---|---|\n| [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io) (official) | **live** | [`makeup.pro/mcp`](https://registry.modelcontextprotocol.io/v0.1/servers?search=makeup.pro) |\n| [PulseMCP](https://www.pulsemcp.com) | auto-ingests from official | expected within 7 days |\n| [Glama](https://glama.ai/mcp) | auto-ingests from official | expected within 1-3 days |\n| [MCP Now](https://mcpnow.io) | auto-ingests from official | expected within days |\n| [Smithery.ai](https://smithery.ai) | manual submission needed (GitHub OAuth) | — |\n| [mcp.so](https://mcp.so) | manual submission needed | see [`docs/registry-submission.md`](./docs/registry-submission.md) |\n\n---\n\n## Reporting issues / requesting changes\n\n- Bug or behavioral issue with a tool: open a [GitHub issue](https://github.com/Evergrow-Management-PTE-LTD/pro-makeup-mcp/issues)\n- Inaccuracy on a specific business listing: report via the listing's \"Report\n  this listing\" link on `pro.makeup`, or email `support@pro.makeup`\n- Security issues: email `support@pro.makeup` directly (do not file a public\n  issue)\n\n---\n\n## License\n\nMIT — see [`LICENSE`](./LICENSE). The `pro.makeup` directory data itself\nis © PRO Makeup / Evergrow Management PTE LTD; the data's usage policy is\ndeclared in the site's [`robots.txt`](https://pro.makeup/robots.txt) via the\nContent-Signal directive (`search=yes, ai-train=yes, ai-input=yes`).\n\n---\n\n## Operator\n\nOperated by **Evergrow Management PTE LTD**. Contact `support@pro.makeup`.\n",
  "bytes": 5827,
  "sha": "5354ee14d21994d67ae4baf34c06773049d51a031b1a1b275b0395f37ac3b617",
  "repo_slug": "evergrow-management-pte-ltd/pro-makeup-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_makeup_pro_mcp_fed5e612/readme"
}