pro.makeup
Search 214K+ certified makeup pros worldwide: artists, salons, schools, shops, brands.
Open source Repository Open in the app JSON README (API)
About
Search 214K+ certified makeup pros worldwide: artists, salons, schools, shops, brands.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- makeup.pro
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-05-28T10:14:20Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-29 04:01:49
- Updated
- 2026-08-29 04:01:49
- Origin id
makeup.pro/mcp
README
# pro.makeup MCP server
Hosted [Model Context Protocol](https://modelcontextprotocol.io) 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):
```json
{
"mcpServers": {
"promakeup": {
"type": "streamable-http",
"url": "https://pro.makeup/api/mcp"
}
}
}
```
### Cursor
Add to `~/.cursor/mcp.json`:
```json
{
"mcpServers": {
"promakeup": {
"url": "https://pro.makeup/api/mcp"
}
}
}
```
### Raw HTTP (`curl`)
```bash
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/`](./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`](./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`](./spec/server-card.json) and
[`spec/openapi.json`](./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`](./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:
| Registry | Status | Link |
|---|---|---|
| [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io) (official) | **live** | [`makeup.pro/mcp`](https://registry.modelcontextprotocol.io/v0.1/servers?search=makeup.pro) |
| [PulseMCP](https://www.pulsemcp.com) | auto-ingests from official | expected within 7 days |
| [Glama](https://glama.ai/mcp) | auto-ingests from official | expected within 1-3 days |
| [MCP Now](https://mcpnow.io) | auto-ingests from official | expected within days |
| [Smithery.ai](https://smithery.ai) | manual submission needed (GitHub OAuth) | — |
| [mcp.so](https://mcp.so) | manual submission needed | see [`docs/registry-submission.md`](./docs/registry-submission.md) |
---
## Reporting issues / requesting changes
- Bug or behavioral issue with a tool: open a [GitHub issue](https://github.com/Evergrow-Management-PTE-LTD/pro-makeup-mcp/issues)
- 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`](./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`](https://pro.makeup/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`.