From 4f06e899e091d8a76b5018747308ae8fbd85f40c Mon Sep 17 00:00:00 2001 From: Brendan Ryan Date: Tue, 24 Mar 2026 14:48:32 -0700 Subject: [PATCH 1/3] docs: align service contribution guidance with MPPScan flow --- .github/workflows/service-pr-guide.yml | 7 +++--- README.md | 32 ++++++++++++++++++++++++-- 2 files changed, 34 insertions(+), 5 deletions(-) diff --git a/.github/workflows/service-pr-guide.yml b/.github/workflows/service-pr-guide.yml index 8b78de4c..db539993 100644 --- a/.github/workflows/service-pr-guide.yml +++ b/.github/workflows/service-pr-guide.yml @@ -20,7 +20,7 @@ jobs: const body = [ '๐Ÿ‘‹ Thanks for submitting a service to the MPP directory!', '', - 'Before we review, please make sure you\'ve completed these steps:', + 'If you want your service included in the curated `mpp.dev/services` list, complete this checklist before review:', '', '### Required', '- [ ] Your service is **live and accepting payments** via MPP (not a placeholder or coming-soon)', @@ -29,13 +29,14 @@ jobs: '- [ ] Build succeeds: `pnpm build`', '', '### Recommended', - '- [ ] Register your service on [MPPScan](https://www.mppscan.com/register) โ€” it follows the standard MPP discovery format and makes your service discoverable by agents immediately, no PR required', + '- [ ] Register your service on [MPPScan](https://www.mppscan.com/register) (by Merit Systems) โ€” it follows the standard MPP discovery format and makes your service discoverable by agents immediately, no PR required', + '- [ ] Join the [MPPscan support group](https://t.me/+AttteHA281VhOWMy) if you need help with registration or listing updates', '', '### Review criteria', 'We prioritize services that are **high quality and novel**. We may not approve services that duplicate existing functionality or aren\'t yet production-ready.', '', '---', - '๐Ÿ“– [Contributing guide](https://github.com/tempoxyz/mpp?tab=readme-ov-file#contributing-to-the-service-directory) ยท ๐Ÿ” [MPPScan](https://www.mppscan.com/register) ยท ๐Ÿ“„ [Protocol docs](https://mpp.dev/protocol/)', + '๐Ÿ“– [Contributing guide](https://github.com/tempoxyz/mpp?tab=readme-ov-file#contributing-to-the-service-directory) ยท ๐Ÿ” [MPPScan](https://www.mppscan.com/register) ยท ๐Ÿ’ฌ [MPPscan support group](https://t.me/+AttteHA281VhOWMy) ยท ๐Ÿ“„ [Protocol docs](https://mpp.dev/protocol/)', ].join('\n'); await github.rest.issues.createComment({ diff --git a/README.md b/README.md index 98fdce50..9d7d9707 100644 --- a/README.md +++ b/README.md @@ -43,7 +43,33 @@ pnpm run preview # Preview production build ## Contributing to the service directory -The service directory at [mpp.dev/services](https://mpp.dev/services) lists all MPP-enabled services. To add or update a service, edit the registry source file and open a pull request. +The service directory at [mpp.dev/services](https://mpp.dev/services) is curated for live, production-ready MPP services. + +### Fast path (recommended) + +Register your service on [MPPScan](https://www.mppscan.com/register) (by Merit Systems) โ€” it follows the standard MPP discovery format and makes your service discoverable by agents immediately, no PR required. + +Need help registering? Join the [MPPscan support group](https://t.me/+AttteHA281VhOWMy). + +### Submit a pull request to this repo + +If you want your service included in the curated `mpp.dev/services` list, open a PR and complete this checklist: + +#### Required + +- [ ] Your service is **live and accepting payments** via MPP (not a placeholder or coming-soon) +- [ ] You've added your entry to `schemas/services.ts` +- [ ] Types pass: `pnpm check:types` +- [ ] Build succeeds: `pnpm build` + +#### Recommended + +- [ ] Register your service on [MPPScan](https://www.mppscan.com/register) (by Merit Systems) โ€” it follows the standard MPP discovery format and makes your service discoverable by agents immediately, no PR required +- [ ] Join the [MPPscan support group](https://t.me/+AttteHA281VhOWMy) if you need help with registration or listing updates + +#### Review criteria + +We prioritize services that are **high quality and novel**. We may not approve services that duplicate existing functionality or aren't yet production-ready. ### Add a new service @@ -89,6 +115,8 @@ pnpm build 4. **Open a pull request** with both `schemas/services.ts` and `schemas/discovery.json` changes. +Need help? See [MPPscan support group](https://t.me/+AttteHA281VhOWMy). + ## Contributing Contributions to documentation, the service directory, and site improvements are welcome. @@ -106,7 +134,7 @@ Contributions to documentation, the service directory, and site improvements are |-------------|---------| | Typo or editorial fix | Direct PR to `main` | | New documentation page | Follow existing page structure in `src/pages/` | -| New service listing | Edit `schemas/services.ts`, regenerate, PR | +| New service listing | Register on [MPPScan](https://www.mppscan.com/register) for immediate discovery; open a PR to include it in the curated `mpp.dev/services` list | | Service update | Edit the service entry in `schemas/services.ts`, regenerate, PR | | New component | Follow patterns in `src/components/` | | Site configuration | Open an issue first for discussion | From 6a677de65a7e7bcaec61af8a93067cd4d415aa08 Mon Sep 17 00:00:00 2001 From: Brendan Ryan Date: Tue, 24 Mar 2026 14:51:52 -0700 Subject: [PATCH 2/3] docs: remove telegram support group references --- .github/workflows/service-pr-guide.yml | 3 +-- README.md | 5 ----- 2 files changed, 1 insertion(+), 7 deletions(-) diff --git a/.github/workflows/service-pr-guide.yml b/.github/workflows/service-pr-guide.yml index db539993..b7c42e59 100644 --- a/.github/workflows/service-pr-guide.yml +++ b/.github/workflows/service-pr-guide.yml @@ -30,13 +30,12 @@ jobs: '', '### Recommended', '- [ ] Register your service on [MPPScan](https://www.mppscan.com/register) (by Merit Systems) โ€” it follows the standard MPP discovery format and makes your service discoverable by agents immediately, no PR required', - '- [ ] Join the [MPPscan support group](https://t.me/+AttteHA281VhOWMy) if you need help with registration or listing updates', '', '### Review criteria', 'We prioritize services that are **high quality and novel**. We may not approve services that duplicate existing functionality or aren\'t yet production-ready.', '', '---', - '๐Ÿ“– [Contributing guide](https://github.com/tempoxyz/mpp?tab=readme-ov-file#contributing-to-the-service-directory) ยท ๐Ÿ” [MPPScan](https://www.mppscan.com/register) ยท ๐Ÿ’ฌ [MPPscan support group](https://t.me/+AttteHA281VhOWMy) ยท ๐Ÿ“„ [Protocol docs](https://mpp.dev/protocol/)', + '๐Ÿ“– [Contributing guide](https://github.com/tempoxyz/mpp?tab=readme-ov-file#contributing-to-the-service-directory) ยท ๐Ÿ” [MPPScan](https://www.mppscan.com/register) ยท ๐Ÿ“„ [Protocol docs](https://mpp.dev/protocol/)', ].join('\n'); await github.rest.issues.createComment({ diff --git a/README.md b/README.md index 9d7d9707..68720ee8 100644 --- a/README.md +++ b/README.md @@ -49,8 +49,6 @@ The service directory at [mpp.dev/services](https://mpp.dev/services) is curated Register your service on [MPPScan](https://www.mppscan.com/register) (by Merit Systems) โ€” it follows the standard MPP discovery format and makes your service discoverable by agents immediately, no PR required. -Need help registering? Join the [MPPscan support group](https://t.me/+AttteHA281VhOWMy). - ### Submit a pull request to this repo If you want your service included in the curated `mpp.dev/services` list, open a PR and complete this checklist: @@ -65,7 +63,6 @@ If you want your service included in the curated `mpp.dev/services` list, open a #### Recommended - [ ] Register your service on [MPPScan](https://www.mppscan.com/register) (by Merit Systems) โ€” it follows the standard MPP discovery format and makes your service discoverable by agents immediately, no PR required -- [ ] Join the [MPPscan support group](https://t.me/+AttteHA281VhOWMy) if you need help with registration or listing updates #### Review criteria @@ -115,8 +112,6 @@ pnpm build 4. **Open a pull request** with both `schemas/services.ts` and `schemas/discovery.json` changes. -Need help? See [MPPscan support group](https://t.me/+AttteHA281VhOWMy). - ## Contributing Contributions to documentation, the service directory, and site improvements are welcome. From 1a4d85941cd669a7b02877cf22a3a48bde662344 Mon Sep 17 00:00:00 2001 From: Brendan Ryan Date: Tue, 24 Mar 2026 14:55:25 -0700 Subject: [PATCH 3/3] Update README.md --- README.md | 19 ------------------- 1 file changed, 19 deletions(-) diff --git a/README.md b/README.md index 68720ee8..1d8540ad 100644 --- a/README.md +++ b/README.md @@ -45,10 +45,6 @@ pnpm run preview # Preview production build The service directory at [mpp.dev/services](https://mpp.dev/services) is curated for live, production-ready MPP services. -### Fast path (recommended) - -Register your service on [MPPScan](https://www.mppscan.com/register) (by Merit Systems) โ€” it follows the standard MPP discovery format and makes your service discoverable by agents immediately, no PR required. - ### Submit a pull request to this repo If you want your service included in the curated `mpp.dev/services` list, open a PR and complete this checklist: @@ -97,21 +93,6 @@ We prioritize services that are **high quality and novel**. We may not approve s } ``` -2. **Regenerate the discovery file**: - -```bash -node scripts/generate-discovery.ts -``` - -3. **Validate**: - -```bash -pnpm check:types -pnpm build -``` - -4. **Open a pull request** with both `schemas/services.ts` and `schemas/discovery.json` changes. - ## Contributing Contributions to documentation, the service directory, and site improvements are welcome.