mpp32-mcp-server 1.0.0 → 1.0.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.
- package/README.md +190 -78
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,26 +1,69 @@
|
|
|
1
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<h1 align="center">MPP32</h1>
|
|
3
|
+
<p align="center"><strong>Universal Payment Proxy for Machine-Payable APIs</strong></p>
|
|
4
|
+
<p align="center">
|
|
5
|
+
<a href="https://www.npmjs.com/package/mpp32-mcp-server"><img src="https://img.shields.io/npm/v/mpp32-mcp-server.svg?style=flat-square&color=0052FF" alt="npm version"></a>
|
|
6
|
+
<a href="https://www.npmjs.com/package/mpp32-mcp-server"><img src="https://img.shields.io/npm/dm/mpp32-mcp-server.svg?style=flat-square&color=0052FF" alt="npm downloads"></a>
|
|
7
|
+
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-0052FF.svg?style=flat-square" alt="License: MIT"></a>
|
|
8
|
+
<a href="https://mpp32.org"><img src="https://img.shields.io/badge/Website-mpp32.org-0052FF?style=flat-square" alt="Website"></a>
|
|
9
|
+
</p>
|
|
10
|
+
</p>
|
|
2
11
|
|
|
3
|
-
|
|
12
|
+
---
|
|
4
13
|
|
|
5
|
-
|
|
14
|
+
**MCP server that gives AI agents the ability to discover, pay for, and consume APIs autonomously.**
|
|
6
15
|
|
|
7
|
-
|
|
16
|
+
One integration. Five payment protocols. Instant settlement. No subscriptions, no API keys, no checkout screens — just agents paying for what they use.
|
|
8
17
|
|
|
9
|
-
|
|
18
|
+
---
|
|
10
19
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
20
|
+
## Why MPP32
|
|
21
|
+
|
|
22
|
+
The agent economy needs a payment layer. Today, agents can browse the web and call APIs — but they can't pay for premium data or services without a human setting up accounts and credentials for each provider.
|
|
23
|
+
|
|
24
|
+
MPP32 solves this. It's a universal proxy that sits between agents and API providers, handling payment negotiation across **five protocols** so neither side has to implement the others:
|
|
25
|
+
|
|
26
|
+
```
|
|
27
|
+
┌─────────────┐ ┌─────────────┐ ┌──────────────────┐
|
|
28
|
+
│ AI Agent │ ──────> │ MPP32 │ ──────> │ API Provider │
|
|
29
|
+
│ (Claude, │ 402 │ Payment │ paid │ (Data, Intel, │
|
|
30
|
+
│ GPT, etc.) │ <────── │ Proxy │ <────── │ Services) │
|
|
31
|
+
│ │ retry │ │ response│ │
|
|
32
|
+
│ │ ──────> │ ✓ verified │ ──────> │ │
|
|
33
|
+
└─────────────┘ └─────────────┘ └──────────────────┘
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
**For agents:** Pay-per-call access to any API in the ecosystem. No accounts. No subscriptions.
|
|
37
|
+
|
|
38
|
+
**For providers:** List once, get paid via any protocol. No payment integration needed.
|
|
39
|
+
|
|
40
|
+
---
|
|
41
|
+
|
|
42
|
+
## Supported Payment Protocols
|
|
43
|
+
|
|
44
|
+
| Protocol | Type | Settlement | Network | Speed |
|
|
45
|
+
|:---------|:-----|:-----------|:--------|:------|
|
|
46
|
+
| **x402** | Payment | USDC | Solana Mainnet | ~200ms |
|
|
47
|
+
| **Tempo** | Payment | pathUSD | Ethereum L2 | ~500ms |
|
|
48
|
+
| **ACP** | Payment | Checkout sessions | Multi-chain | Session-based |
|
|
49
|
+
| **AP2** | Authorization | W3C Verifiable Credentials | Chain-agnostic | Instant |
|
|
50
|
+
| **AGTP** | Identity | HMAC-signed agent certs | Chain-agnostic | Instant |
|
|
51
|
+
|
|
52
|
+
All five protocols are accepted on every endpoint. Agents choose their preferred method. MPP32 handles verification and settlement.
|
|
53
|
+
|
|
54
|
+
---
|
|
18
55
|
|
|
19
56
|
## Quick Start
|
|
20
57
|
|
|
21
|
-
###
|
|
58
|
+
### Install
|
|
22
59
|
|
|
23
|
-
|
|
60
|
+
```bash
|
|
61
|
+
npx mpp32-mcp-server
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### Claude Desktop & Claude Code
|
|
65
|
+
|
|
66
|
+
Add to your MCP configuration file:
|
|
24
67
|
|
|
25
68
|
```json
|
|
26
69
|
{
|
|
@@ -29,112 +72,181 @@ Add to your MCP configuration:
|
|
|
29
72
|
"command": "npx",
|
|
30
73
|
"args": ["mpp32-mcp-server"],
|
|
31
74
|
"env": {
|
|
32
|
-
"MPP32_SOLANA_PRIVATE_KEY": "your-solana-private-key"
|
|
75
|
+
"MPP32_SOLANA_PRIVATE_KEY": "your-solana-private-key-for-usdc-payments"
|
|
33
76
|
}
|
|
34
77
|
}
|
|
35
78
|
}
|
|
36
79
|
}
|
|
37
80
|
```
|
|
38
81
|
|
|
39
|
-
### Other MCP Clients
|
|
82
|
+
### Cursor, Windsurf, and Other MCP Clients
|
|
40
83
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
84
|
+
Same configuration format — add `mpp32` to your MCP server list with at least one payment key.
|
|
85
|
+
|
|
86
|
+
---
|
|
44
87
|
|
|
45
88
|
## Tools
|
|
46
89
|
|
|
90
|
+
This server exposes three tools that any MCP-compatible agent can call:
|
|
91
|
+
|
|
47
92
|
### `list_mpp32_services`
|
|
48
93
|
|
|
49
|
-
Browse
|
|
94
|
+
**Browse the API marketplace.** Returns all registered services with names, categories, pricing, and proxy URLs.
|
|
50
95
|
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
|
|
96
|
+
```typescript
|
|
97
|
+
// Example: find all crypto data providers
|
|
98
|
+
{ category: "token-scanner" }
|
|
99
|
+
|
|
100
|
+
// Returns:
|
|
101
|
+
// - MPP32 Solana Intelligence Oracle ($0.008/query)
|
|
102
|
+
// - ... more services as providers register
|
|
54
103
|
```
|
|
55
104
|
|
|
105
|
+
> **30+ categories:** ai-inference, token-scanner, price-oracle, web-search, trading-signal, defi-analytics, wallet-intelligence, on-chain-data, market-data, image-generation, embeddings, and more.
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
56
109
|
### `get_solana_token_intelligence`
|
|
57
110
|
|
|
58
|
-
|
|
111
|
+
**Real-time Solana token analysis.** Aggregates data from DexScreener, Jupiter, and CoinGecko into a single intelligence report.
|
|
112
|
+
|
|
113
|
+
```typescript
|
|
114
|
+
{ token: "BONK" }
|
|
115
|
+
// or
|
|
116
|
+
{ token: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" }
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
**Returns:**
|
|
120
|
+
|
|
121
|
+
| Field | Description |
|
|
122
|
+
|:------|:------------|
|
|
123
|
+
| Alpha Score | 0-100 trading viability assessment |
|
|
124
|
+
| Rug Risk | Score + level + contributing factors |
|
|
125
|
+
| Whale Activity | Volume-to-liquidity ratio with buy/sell breakdown |
|
|
126
|
+
| Smart Money Signals | Pattern detection from transaction data |
|
|
127
|
+
| Pump Probability | Statistical 24h price movement prediction |
|
|
128
|
+
| Projected ROI | Low/high scenarios with timeframe |
|
|
129
|
+
| Market Data | Price, volume, liquidity, market cap, pair age |
|
|
59
130
|
|
|
60
|
-
|
|
61
|
-
- **Rug Risk Score** — liquidity, age, holder distribution analysis
|
|
62
|
-
- **Whale Activity** — volume-to-liquidity ratio tracking
|
|
63
|
-
- **Smart Money Signals** — real-time pattern detection
|
|
64
|
-
- **24h Pump Probability** — statistical price movement prediction
|
|
65
|
-
- **Projected ROI** — low/high scenario modeling
|
|
66
|
-
- **Full Market Data** — price, volume, liquidity, market cap
|
|
131
|
+
**Pricing:** $0.008 per query. M32 token holders receive automatic discounts (20% at 250K, 40% at 1M tokens).
|
|
67
132
|
|
|
68
|
-
|
|
133
|
+
---
|
|
69
134
|
|
|
70
135
|
### `call_mpp32_endpoint`
|
|
71
136
|
|
|
72
|
-
Call any
|
|
137
|
+
**Call any API in the ecosystem.** Handles the complete HTTP 402 payment flow automatically:
|
|
138
|
+
|
|
139
|
+
```typescript
|
|
140
|
+
{
|
|
141
|
+
slug: "mpp32-intelligence",
|
|
142
|
+
method: "POST",
|
|
143
|
+
body: "{\"token\": \"SOL\"}"
|
|
144
|
+
}
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
**Payment flow (fully automatic):**
|
|
148
|
+
|
|
149
|
+
1. Sends request to the MPP32 proxy
|
|
150
|
+
2. Receives HTTP 402 with payment challenge headers
|
|
151
|
+
3. Selects best available payment protocol
|
|
152
|
+
4. Signs transaction with your configured key
|
|
153
|
+
5. Retries request with payment receipt attached
|
|
154
|
+
6. Returns the API response to your agent
|
|
73
155
|
|
|
74
|
-
|
|
75
|
-
2. Sends the initial request
|
|
76
|
-
3. Receives the HTTP 402 payment challenge
|
|
77
|
-
4. Completes payment via Tempo or x402
|
|
78
|
-
5. Retries with payment receipt
|
|
79
|
-
6. Returns the response
|
|
156
|
+
No manual payment logic. No API keys to manage. No accounts to create.
|
|
80
157
|
|
|
81
|
-
|
|
158
|
+
---
|
|
82
159
|
|
|
83
160
|
## Configuration
|
|
84
161
|
|
|
85
|
-
|
|
|
86
|
-
|
|
87
|
-
| `MPP32_SOLANA_PRIVATE_KEY` |
|
|
88
|
-
| `MPP32_PRIVATE_KEY` |
|
|
89
|
-
| `MPP32_API_URL` | No |
|
|
162
|
+
| Variable | Required | Description |
|
|
163
|
+
|:---------|:---------|:------------|
|
|
164
|
+
| `MPP32_SOLANA_PRIVATE_KEY` | Recommended | Solana private key for **x402** payments (USDC). Fastest settlement (~200ms). |
|
|
165
|
+
| `MPP32_PRIVATE_KEY` | Alternative | EVM private key for **Tempo** payments (pathUSD on Ethereum L2). |
|
|
166
|
+
| `MPP32_API_URL` | No | Override the API base URL. Default: `https://mpp32.org` |
|
|
90
167
|
|
|
91
|
-
|
|
168
|
+
> **Security:** Private keys are used locally to sign payment transactions. They are never transmitted to MPP32 servers. The MCP server runs on your machine.
|
|
92
169
|
|
|
93
|
-
|
|
170
|
+
Set at least one payment key. Set both for maximum protocol compatibility and automatic fallback.
|
|
171
|
+
|
|
172
|
+
---
|
|
173
|
+
|
|
174
|
+
## Architecture
|
|
94
175
|
|
|
95
176
|
```
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
177
|
+
┌─────────────────────────────────────┐
|
|
178
|
+
│ MPP32 Platform │
|
|
179
|
+
│ │
|
|
180
|
+
┌──────────┐ HTTP │ ┌───────────┐ ┌──────────────┐ │ HTTP ┌──────────────┐
|
|
181
|
+
│ │ ──────────> │ │ Payment │ │ Provider │ │ ────────> │ │
|
|
182
|
+
│ MCP │ 402 │ │ Middleware │───>│ Registry │ │ │ Upstream │
|
|
183
|
+
│ Server │ <────────── │ │ │ │ │ │ │ API │
|
|
184
|
+
│ (this) │ + key │ │ x402 │ │ Verification │ │ <──────── │ Provider │
|
|
185
|
+
│ │ ──────────> │ │ Tempo │ │ 24h re-check │ │ │ │
|
|
186
|
+
│ │ 200 │ │ ACP │ │ 3-strike │ │ │ │
|
|
187
|
+
│ │ <────────── │ │ AP2 │ │ suspension │ │ └──────────────┘
|
|
188
|
+
└──────────┘ │ │ AGTP │ └──────────────┘ │
|
|
189
|
+
│ └───────────┘ │
|
|
190
|
+
│ │
|
|
191
|
+
│ ┌───────────────────────────────┐ │
|
|
192
|
+
│ │ Discovery Layer │ │
|
|
193
|
+
│ │ OpenAPI 3.1 · A2A Agent Card │ │
|
|
194
|
+
│ │ MCP Config · Service Directory│ │
|
|
195
|
+
│ └───────────────────────────────┘ │
|
|
196
|
+
└─────────────────────────────────────┘
|
|
112
197
|
```
|
|
113
198
|
|
|
114
|
-
|
|
199
|
+
**Payment verification is real.** x402 payments are verified on-chain via the Solana facilitator. Tempo payments are verified cryptographically via the mppx SDK. ACP sessions are database-backed with checkout flow. AP2 mandates use ECDSA P-256 signature verification. AGTP requires HMAC-SHA256 signed agent certificates.
|
|
200
|
+
|
|
201
|
+
---
|
|
115
202
|
|
|
116
|
-
## Discovery
|
|
203
|
+
## Discovery & Interoperability
|
|
117
204
|
|
|
118
|
-
MPP32
|
|
205
|
+
MPP32 implements standard discovery protocols so any agent framework can find and integrate with the ecosystem:
|
|
119
206
|
|
|
120
|
-
|
|
|
121
|
-
|
|
122
|
-
| OpenAPI 3.1 | `https://mpp32.org/openapi.json
|
|
123
|
-
| A2A Agent Card | `https://mpp32.org/.well-known/agent.json
|
|
124
|
-
| MCP Config | `https://mpp32.org/api/mcp-config
|
|
125
|
-
| Service Directory | `https://mpp32.org/api/submissions
|
|
207
|
+
| Standard | Endpoint | Purpose |
|
|
208
|
+
|:---------|:---------|:--------|
|
|
209
|
+
| **OpenAPI 3.1** | [`/openapi.json`](https://mpp32.org/openapi.json) | Full API specification with payment metadata |
|
|
210
|
+
| **A2A Agent Card** | [`/.well-known/agent.json`](https://mpp32.org/.well-known/agent.json) | Agent-to-agent capability discovery |
|
|
211
|
+
| **MCP Config** | [`/api/mcp-config`](https://mpp32.org/api/mcp-config) | Model Context Protocol server configuration |
|
|
212
|
+
| **Service Directory** | [`/api/submissions`](https://mpp32.org/api/submissions) | Live registry of all API providers |
|
|
213
|
+
|
|
214
|
+
Every paid endpoint returns HTTP 402 with challenge headers for all active protocols, enabling any compliant agent to complete payment regardless of which protocol it implements.
|
|
215
|
+
|
|
216
|
+
---
|
|
126
217
|
|
|
127
218
|
## For API Providers
|
|
128
219
|
|
|
129
|
-
|
|
220
|
+
**Register your API once. Get paid via five protocols automatically.**
|
|
221
|
+
|
|
222
|
+
MPP32 acts as a reverse proxy — you provide the endpoint, we handle:
|
|
223
|
+
|
|
224
|
+
- Payment negotiation and verification across all 5 protocols
|
|
225
|
+
- Endpoint health monitoring with 24-hour re-verification
|
|
226
|
+
- Discovery listing via OpenAPI, A2A, and MCP standards
|
|
227
|
+
- Analytics dashboard with query counts, revenue, and latency metrics
|
|
228
|
+
- USDC and pathUSD settlement to your wallet
|
|
229
|
+
|
|
230
|
+
Register at **[mpp32.org/build](https://mpp32.org/build)**.
|
|
231
|
+
|
|
232
|
+
---
|
|
130
233
|
|
|
131
234
|
## Links
|
|
132
235
|
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
236
|
+
| Resource | URL |
|
|
237
|
+
|:---------|:----|
|
|
238
|
+
| Website | [mpp32.org](https://mpp32.org) |
|
|
239
|
+
| Documentation | [mpp32.org/docs](https://mpp32.org/docs) |
|
|
240
|
+
| API Playground | [mpp32.org/playground](https://mpp32.org/playground) |
|
|
241
|
+
| Ecosystem | [mpp32.org/ecosystem](https://mpp32.org/ecosystem) |
|
|
242
|
+
| Use Cases | [mpp32.org/use-cases](https://mpp32.org/use-cases) |
|
|
243
|
+
| GitHub | [github.com/MPP32/MPP32](https://github.com/MPP32/MPP32) |
|
|
244
|
+
|
|
245
|
+
---
|
|
246
|
+
|
|
247
|
+
<p align="center">
|
|
248
|
+
<strong>MPP32</strong> — The payment layer for the agent economy.
|
|
249
|
+
</p>
|
|
138
250
|
|
|
139
251
|
## License
|
|
140
252
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mpp32-mcp-server",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"description": "MCP server for MPP32 — Universal Payment Proxy for Machine-Payable APIs. Lets AI agents discover, pay for, and call APIs across 5 payment protocols.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|