payflowagent-mcp 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +129 -83
  2. package/package.json +6 -2
package/README.md CHANGED
@@ -1,107 +1,153 @@
1
- # PayFlowAgent MCP-Server
2
-
3
- Bindet den PayFlowAgent-Dienst (Token-Intelligence fuer nad.fun auf Monad) als
4
- **MCP-Server** in KI-Agenten ein — Cursor, Claude Desktop oder eigene Agenten.
5
-
6
- Warum: Je niedriger die Integrationshuerde, desto eher kommt der naechste bezahlte
7
- Call. Ein Agent fuegt einmal diesen Server hinzu und kann danach Token bewerten —
8
- die bezahlten Tools begleichen den Preis automatisch in USDC via **x402**.
9
-
10
- ## Tools
11
-
12
- | Tool | Preis | Beschreibung |
13
- |-----------------|--------------|--------------|
14
- | `score_token` | kostenlos | 0–100 Score, `riskLevel`, `action` (rate-limitiert). |
15
- | `decide_token` | bezahlt (x402) | Voller Report: Faktoren, Graduation, Momentum. |
16
- | `token_summary` | bezahlt (x402) | Graduation-Fortschritt + Momentum (guenstiger Einstieg). |
17
- | `screen_tokens` | bezahlt (x402) | Gerankte Liste vorgescorter neuer Token. |
18
-
19
- ## Konfiguration (Env)
20
-
21
- | Variable | Default | Zweck |
22
- |--------------------------|-------------------------------|-------|
23
- | `PAYFLOWAGENT_API_BASE` | `https://payflowagent.net` | Basis-URL des Dienstes. |
24
- | `X402_BUYER_PRIVATE_KEY` | — | Private Key einer **dedizierten** Zahler-Wallet (Base, USDC). Ohne Key laufen nur kostenlose Tools. |
25
- | `X402_BUYER_RPC` | `https://mainnet.base.org` | Zahlungs-RPC (optional). |
26
-
27
- > Sicherheit: Nutze eine separate Wallet nur fuer diese Zahlungen, niemals die
28
- > Empfangs-Wallet oder eine Wallet mit grossem Guthaben. Der Key wird ausschliesslich
29
- > aus der Env gelesen.
30
-
31
- ## Einbinden in Cursor
32
-
33
- `~/.cursor/mcp.json` (oder Projekt-`.cursor/mcp.json`):
34
-
35
- ```json
36
- {
37
- "mcpServers": {
38
- "payflowagent": {
39
- "command": "npx",
40
- "args": ["-y", "payflowagent-mcp"],
41
- "env": {
42
- "X402_BUYER_PRIVATE_KEY": "0x..."
43
- }
44
- }
45
- }
46
- }
1
+ # MCP Registry
2
+
3
+ The MCP registry provides MCP clients with a list of MCP servers, like an app store for MCP servers.
4
+
5
+ [**📤 Publish my MCP server**](docs/modelcontextprotocol-io/quickstart.mdx) | [**⚡️ Live API docs**](https://registry.modelcontextprotocol.io/docs) | [**👀 Ecosystem vision**](docs/design/ecosystem-vision.md) | 📖 **[Full documentation](./docs)**
6
+
7
+ ## Development Status
8
+
9
+ **2025-10-24 update**: The Registry API has entered an **API freeze (v0.1)** 🎉. For the next month or more, the API will remain stable with no breaking changes, allowing integrators to confidently implement support. This freeze applies to v0.1 while development continues on v0. We'll use this period to validate the API in real-world integrations and gather feedback to shape v1 for general availability. Thank you to everyone for your contributions and patience—your involvement has been key to getting us here!
10
+
11
+ **2025-09-08 update**: The registry has launched in preview 🎉 ([announcement blog post](https://blog.modelcontextprotocol.io/posts/2025-09-08-mcp-registry-preview/)). While the system is now more stable, this is still a preview release and breaking changes or data resets may occur. A general availability (GA) release will follow later. We'd love your feedback in [GitHub discussions](https://github.com/modelcontextprotocol/registry/discussions/new?category=ideas) or in the [#registry-dev Discord](https://discord.com/channels/1358869848138059966/1369487942862504016) ([joining details here](https://modelcontextprotocol.io/community/communication)).
12
+
13
+ Current key maintainers:
14
+ - **Adam Jones** (Anthropic) [@domdomegg](https://github.com/domdomegg)
15
+ - **Tadas Antanavicius** (PulseMCP) [@tadasant](https://github.com/tadasant)
16
+ - **Toby Padilla** (GitHub) [@toby](https://github.com/toby)
17
+ - **Radoslav (Rado) Dimitrov** (Stacklok) [@rdimitrov](https://github.com/rdimitrov)
18
+
19
+ ## Contributing
20
+
21
+ We use multiple channels for collaboration - see [modelcontextprotocol.io/community/communication](https://modelcontextprotocol.io/community/communication).
22
+
23
+ Often (but not always) ideas flow through this pipeline:
24
+
25
+ - **[Discord](https://modelcontextprotocol.io/community/communication)** - Real-time community discussions
26
+ - **[Discussions](https://github.com/modelcontextprotocol/registry/discussions)** - Propose and discuss product/technical requirements
27
+ - **[Issues](https://github.com/modelcontextprotocol/registry/issues)** - Track well-scoped technical work
28
+ - **[Pull Requests](https://github.com/modelcontextprotocol/registry/pulls)** - Contribute work towards issues
29
+
30
+ ### Quick start:
31
+
32
+ #### Pre-requisites
33
+
34
+ - **Docker**
35
+ - **Go 1.24.x**
36
+ - **ko** - Container image builder for Go ([installation instructions](https://ko.build/install/))
37
+ - **golangci-lint v2.4.0**
38
+
39
+ #### Running the server
40
+
41
+ ```bash
42
+ # Start full development environment
43
+ make dev-compose
47
44
  ```
48
45
 
49
- ## Einbinden in Claude Desktop
46
+ This starts the registry at [`localhost:8080`](http://localhost:8080) with PostgreSQL. The database uses ephemeral storage and is reset each time you restart the containers, ensuring a clean state for development and testing.
47
+
48
+ **Note:** The registry uses [ko](https://ko.build) to build container images. The `make dev-compose` command automatically builds the registry image with ko and loads it into your local Docker daemon before starting the services.
50
49
 
51
- `claude_desktop_config.json`:
50
+ By default, the registry seeds from the production API with a filtered subset of servers (to keep startup fast). This ensures your local environment mirrors production behavior and all seed data passes validation. For offline development you can seed from a file without validation with `MCP_REGISTRY_SEED_FROM=data/seed.json MCP_REGISTRY_ENABLE_REGISTRY_VALIDATION=false make dev-compose`.
52
51
 
53
- ```json
54
- {
55
- "mcpServers": {
56
- "payflowagent": {
57
- "command": "npx",
58
- "args": ["-y", "payflowagent-mcp"],
59
- "env": { "X402_BUYER_PRIVATE_KEY": "0x..." }
60
- }
61
- }
62
- }
52
+ The setup can be configured with environment variables in [docker-compose.yml](./docker-compose.yml) - see [.env.example](./.env.example) for a reference.
53
+
54
+ <details>
55
+ <summary>Alternative: Running a pre-built Docker image</summary>
56
+
57
+ Pre-built Docker images are automatically published to GitHub Container Registry. Note that the image does not bundle PostgreSQL, so you need to run your own and point the registry at it via `MCP_REGISTRY_DATABASE_URL` (see [docker-compose.yml](./docker-compose.yml) for a working example):
58
+
59
+ ```bash
60
+ # Run latest stable release
61
+ docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:latest
62
+
63
+ # Run latest from main branch (continuous deployment)
64
+ docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main
65
+
66
+ # Run specific release version
67
+ docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:v1.0.0
68
+
69
+ # Run development build from main branch
70
+ docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main-20250906-abc123d
63
71
  ```
64
72
 
65
- > Ohne installiertes Paket lädt `npx -y payflowagent-mcp` es automatisch von npm.
66
- > Für lokale Entwicklung statt der npm-Version: `["-y", "tsx", "<absoluter Pfad>/apps/mcp/src/index.ts"]`.
73
+ **Available tags:**
74
+ - **Releases**: `latest`, `v1.0.0`, `v1.1.0`, etc.
75
+ - **Continuous**: `main` (latest main branch build)
76
+ - **Development**: `main-<date>-<sha>` (specific commit builds)
77
+
78
+ </details>
67
79
 
68
- ## Lokal starten / testen
80
+ #### Publishing a server
81
+
82
+ To publish a server, we've built a simple CLI. You can use it with:
69
83
 
70
84
  ```bash
71
- pnpm --filter payflowagent-mcp start # stdio-Server (aus dem Quellcode)
72
- pnpm --filter payflowagent-mcp typecheck
73
- pnpm --filter payflowagent-mcp build # dist/ erzeugen (wie beim Publish)
85
+ # Build the latest CLI
86
+ make publisher
87
+
88
+ # Use it!
89
+ ./bin/mcp-publisher --help
74
90
  ```
75
91
 
76
- ## Veröffentlichen (npm)
92
+ See [the publisher guide](./docs/modelcontextprotocol-io/quickstart.mdx) for more details.
77
93
 
78
- Einmalig vorbereiten und publishen (benötigt deinen npm-Account):
94
+ #### Other commands
79
95
 
80
96
  ```bash
81
- npm login # einmalig
82
- cd apps/mcp
83
- npm publish --access public # baut via prepack automatisch dist/
97
+ # Run lint, unit tests and integration tests
98
+ make check
84
99
  ```
85
100
 
86
- Nach dem Publish funktioniert überall: `npx -y payflowagent-mcp`.
101
+ There are also a few more helpful commands for development. Run `make help` to learn more, or look in [Makefile](./Makefile).
87
102
 
88
- ### Offizielle MCP-Registry (optional)
103
+ <!--
104
+ For Claude and other AI tools: Always prefer make targets over custom commands where possible.
105
+ -->
89
106
 
90
- `server.json` liegt bei. Mit dem offiziellen Publisher:
107
+ ## Architecture
108
+
109
+ ### Project Structure
91
110
 
92
- ```bash
93
- # Publisher installieren: siehe https://github.com/modelcontextprotocol/registry
94
- mcp-publisher login # Namespace net.payflowagent/* via DNS-TXT verifizieren
95
- mcp-publisher publish # nutzt apps/mcp/server.json
96
111
  ```
112
+ ├── cmd/ # Application entry points
113
+ │ └── publisher/ # Server publishing tool
114
+ ├── data/ # Seed data
115
+ ├── deploy/ # Deployment configuration (Pulumi)
116
+ ├── docs/ # Documentation
117
+ ├── internal/ # Private application code
118
+ │ ├── api/ # HTTP handlers and routing
119
+ │ ├── auth/ # Authentication (GitHub OAuth, JWT, namespace blocking)
120
+ │ ├── config/ # Configuration management
121
+ │ ├── database/ # Data persistence (PostgreSQL)
122
+ │ ├── service/ # Business logic
123
+ │ ├── telemetry/ # Metrics and monitoring
124
+ │ └── validators/ # Input validation
125
+ ├── pkg/ # Public packages
126
+ │ ├── api/ # API types and structures
127
+ │ │ └── v0/ # Version 0 API types
128
+ │ └── model/ # Data models for server.json
129
+ ├── scripts/ # Development and testing scripts
130
+ ├── tests/ # Integration tests
131
+ └── tools/ # CLI tools and utilities
132
+ └── validate-*.sh # Schema validation tools
133
+ ```
134
+
135
+ ### Authentication
136
+
137
+ Publishing supports multiple authentication methods:
138
+ - **GitHub OAuth** - For publishing by logging into GitHub
139
+ - **GitHub OIDC** - For publishing from GitHub Actions
140
+ - **DNS verification** - For proving ownership of a domain and its subdomains
141
+ - **HTTP verification** - For proving ownership of a domain
142
+
143
+ The registry validates namespace ownership when publishing. E.g. to publish...:
144
+ - `io.github.domdomegg/my-cool-mcp` you must login to GitHub as `domdomegg`, or be in a GitHub Action on domdomegg's repos
145
+ - `me.adamjones/my-cool-mcp` you must prove ownership of `adamjones.me` via DNS or HTTP challenge
97
146
 
98
- Viele Verzeichnisse (Glama, mcp.so, PulseMCP) indexieren npm zusätzlich automatisch
99
- anhand der `mcp*`-Keywords.
147
+ ## Community Projects
100
148
 
101
- Der Server kommuniziert ueber **stdio** (stdout ist dem MCP-Protokoll vorbehalten;
102
- Statusmeldungen gehen nach stderr).
149
+ Check out [community projects](docs/community-projects.md) to explore notable registry-related work created by the community.
103
150
 
104
- ## Hinweis
151
+ ## More documentation
105
152
 
106
- Ohne `X402_BUYER_PRIVATE_KEY` liefern die bezahlten Tools eine klare Meldung, wie
107
- man Zahlungen aktiviert — `score_token` funktioniert immer kostenlos zum Ausprobieren.
153
+ See the [documentation](./docs) for more details if your question has not been answered here!
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "payflowagent-mcp",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "MCP server for PayFlowAgent — free & pay-per-call (x402/USDC) risk & momentum scores for nad.fun tokens on Monad.",
5
5
  "keywords": [
6
6
  "mcp",
@@ -15,8 +15,12 @@
15
15
  "ai"
16
16
  ],
17
17
  "homepage": "https://payflowagent.net",
18
+ "repository": {
19
+ "type": "git",
20
+ "url": "git+https://github.com/Coinlooter/payflowagent-mcp.git"
21
+ },
18
22
  "bugs": {
19
- "url": "https://payflowagent.net"
23
+ "url": "https://github.com/Coinlooter/payflowagent-mcp/issues"
20
24
  },
21
25
  "license": "MIT",
22
26
  "author": "PayFlowAgent",