mpp32-mcp-server 1.0.3 → 1.1.0
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 +83 -189
- package/dist/index.js +544 -244
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
<p align="center">
|
|
2
2
|
<h1 align="center">MPP32</h1>
|
|
3
|
-
<p align="center"><strong>The
|
|
3
|
+
<p align="center"><strong>The payment layer for AI agents</strong></p>
|
|
4
4
|
<p align="center">
|
|
5
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
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>
|
|
@@ -9,61 +9,43 @@
|
|
|
9
9
|
</p>
|
|
10
10
|
</p>
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
One install. Five payment rails. Thousands of paid APIs your agent can reach without you setting up a single account.
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
## Why this beats running your own integrations
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
Most agent stacks stop at "the model can call a function." That works until the function costs money. The moment your agent needs premium data, a paid model, a trading signal, or a token analytics call, you are back to building accounts, storing API keys, watching budgets, and writing custom 402 handlers for every provider.
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
MPP32 replaces all of that with one MCP server. Your agent asks for a service by name. The server finds it in a federated catalog of thousands of machine payable APIs, negotiates the cheapest protocol, signs payment from a key on your own machine, and returns the data. You write zero billing code. You manage zero provider accounts. Your agent gets faster, cheaper, and reaches services other agents cannot touch.
|
|
19
19
|
|
|
20
|
-
##
|
|
20
|
+
## What your agent can do once this is installed
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
* Browse a live catalog of over 4,500 paid and free APIs across categories like token intelligence, market data, web search, image generation, embeddings, DeFi analytics, wallet scoring, on chain queries, and trading signals.
|
|
23
|
+
* Pay any provider in the catalog using whichever protocol fits, with settlement that lands in seconds.
|
|
24
|
+
* Run real time Solana token intelligence with alpha scoring, rug risk, whale flow, and 24 hour pump probability.
|
|
25
|
+
* Track every call, every dollar settled, and every protocol used from a dashboard at mpp32.org.
|
|
26
|
+
* Get an automatic 20 percent or 40 percent discount on native services for holding M32 once your wallet is verified.
|
|
23
27
|
|
|
24
|
-
|
|
28
|
+
## Payment rails it speaks natively
|
|
25
29
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
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
|
|
30
|
+
| Rail | Settles in | Network |
|
|
31
|
+
|:-----|:-----------|:--------|
|
|
32
|
+
| x402 | USDC | Solana |
|
|
33
|
+
| Tempo | pathUSD | Ethereum L2 |
|
|
34
|
+
| ACP | Checkout session | Multi chain |
|
|
35
|
+
| AP2 | W3C verifiable credentials | Chain agnostic |
|
|
36
|
+
| AGTP | HMAC signed agent certificates | Chain agnostic |
|
|
43
37
|
|
|
44
|
-
|
|
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 |
|
|
38
|
+
Every native endpoint accepts all five. The server picks whichever your wallet is funded for and falls back gracefully if the first attempt fails.
|
|
51
39
|
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
---
|
|
55
|
-
|
|
56
|
-
## Quick Start
|
|
57
|
-
|
|
58
|
-
### Install
|
|
40
|
+
## Install
|
|
59
41
|
|
|
60
42
|
```bash
|
|
61
43
|
npx mpp32-mcp-server
|
|
62
44
|
```
|
|
63
45
|
|
|
64
|
-
### Claude Desktop
|
|
46
|
+
### Claude Desktop, Claude Code, Cursor, Windsurf
|
|
65
47
|
|
|
66
|
-
|
|
48
|
+
Drop this into the MCP servers section of your client config.
|
|
67
49
|
|
|
68
50
|
```json
|
|
69
51
|
{
|
|
@@ -72,190 +54,108 @@ Add to your MCP configuration file:
|
|
|
72
54
|
"command": "npx",
|
|
73
55
|
"args": ["mpp32-mcp-server"],
|
|
74
56
|
"env": {
|
|
75
|
-
"
|
|
57
|
+
"MPP32_AGENT_KEY": "mpp32_agent_…",
|
|
58
|
+
"MPP32_SOLANA_PRIVATE_KEY": "your_solana_private_key_for_usdc"
|
|
76
59
|
}
|
|
77
60
|
}
|
|
78
61
|
}
|
|
79
62
|
}
|
|
80
63
|
```
|
|
81
64
|
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
Same configuration format — add `mpp32` to your MCP server list with at least one payment key.
|
|
85
|
-
|
|
86
|
-
---
|
|
65
|
+
Get an `MPP32_AGENT_KEY` at [mpp32.org/agent-console](https://mpp32.org/agent-console). No signup, no email, just a session form. With an agent key every call is attributed to your dashboard so you can see spend, success rate, and protocol breakdown. Without it the server still works but you only see native services and the calls stay anonymous.
|
|
87
66
|
|
|
88
|
-
|
|
67
|
+
`MPP32_SOLANA_PRIVATE_KEY` and `MPP32_PRIVATE_KEY` are only needed for paid services. Free services in the catalog work without any key.
|
|
89
68
|
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
### `list_mpp32_services`
|
|
93
|
-
|
|
94
|
-
**Browse the API marketplace.** Returns all registered services with names, categories, pricing, and proxy URLs.
|
|
95
|
-
|
|
96
|
-
```typescript
|
|
97
|
-
// Example: find all crypto data providers
|
|
98
|
-
{ category: "token-scanner" }
|
|
69
|
+
## Configuration
|
|
99
70
|
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
71
|
+
| Variable | When you need it | What it does |
|
|
72
|
+
|:---------|:-----------------|:-------------|
|
|
73
|
+
| `MPP32_AGENT_KEY` | Recommended | Session key from mpp32.org/agent-console. Unlocks the full federated catalog and dashboard tracking. Also accepted as `MPP32_API_KEY`. |
|
|
74
|
+
| `MPP32_SOLANA_PRIVATE_KEY` | Paid x402 calls | Solana key used to sign USDC payments locally. |
|
|
75
|
+
| `MPP32_PRIVATE_KEY` | Paid Tempo calls | EVM key used to sign pathUSD payments locally on Ethereum L2. |
|
|
76
|
+
| `MPP32_API_URL` | Custom deployments | Override the API base URL. Defaults to `https://mpp32.org`. |
|
|
104
77
|
|
|
105
|
-
|
|
78
|
+
Private keys stay on your machine. They sign payments locally and never travel to MPP32 servers. Provide one or both for paid calls. If both are present, x402 is tried first and Tempo is used as a fallback.
|
|
106
79
|
|
|
107
|
-
|
|
80
|
+
## Tools your agent will see
|
|
108
81
|
|
|
109
|
-
### `
|
|
82
|
+
### `list_mpp32_services`
|
|
110
83
|
|
|
111
|
-
|
|
84
|
+
Browse the federated catalog. Returns native, curated free, x402 bazaar, and MCP registry entries with pricing, supported protocols, and a clear flag on every row that tells the agent whether it can actually call the service through this MCP or whether the entry is for discovery only.
|
|
112
85
|
|
|
113
|
-
```
|
|
114
|
-
{ token: "
|
|
115
|
-
// or
|
|
116
|
-
{ token: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" }
|
|
86
|
+
```json
|
|
87
|
+
{ "category": "token-scanner", "q": "solana", "source": "native" }
|
|
117
88
|
```
|
|
118
89
|
|
|
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 |
|
|
130
|
-
|
|
131
|
-
**Pricing:** $0.008 per query. M32 token holders are eligible for tiered discounts (20% at 250K, 40% at 1M tokens) once wallet ownership is verified through the [agent console](https://mpp32.org/agent-console).
|
|
132
|
-
|
|
133
|
-
---
|
|
134
|
-
|
|
135
90
|
### `call_mpp32_endpoint`
|
|
136
91
|
|
|
137
|
-
|
|
92
|
+
Call any HTTP callable service in the catalog. Free services return immediately. Paid services return a 402 challenge that this tool signs and retries automatically when a payment key is configured.
|
|
138
93
|
|
|
139
|
-
```
|
|
94
|
+
```json
|
|
140
95
|
{
|
|
141
|
-
slug: "mpp32-intelligence",
|
|
142
|
-
method: "POST",
|
|
143
|
-
body:
|
|
96
|
+
"slug": "mpp32-intelligence",
|
|
97
|
+
"method": "POST",
|
|
98
|
+
"body": { "token": "SOL" }
|
|
144
99
|
}
|
|
145
100
|
```
|
|
146
101
|
|
|
147
|
-
|
|
102
|
+
Under the hood:
|
|
148
103
|
|
|
149
|
-
1.
|
|
150
|
-
2.
|
|
151
|
-
3.
|
|
152
|
-
4.
|
|
153
|
-
5.
|
|
154
|
-
6.
|
|
104
|
+
1. Send the request to `/api/agent/execute`.
|
|
105
|
+
2. If the service is free, hand the response back.
|
|
106
|
+
3. If the service is paid, read the 402 challenge.
|
|
107
|
+
4. Pick the protocol your wallet can satisfy.
|
|
108
|
+
5. Sign the transaction locally.
|
|
109
|
+
6. Retry with the receipt attached.
|
|
110
|
+
7. Return the data with the settled amount, the protocol used, and the on chain settlement signature.
|
|
155
111
|
|
|
156
|
-
No
|
|
157
|
-
|
|
158
|
-
---
|
|
159
|
-
|
|
160
|
-
## Configuration
|
|
112
|
+
No payment logic in your code. No per provider keys to juggle.
|
|
161
113
|
|
|
162
|
-
|
|
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` |
|
|
167
|
-
|
|
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.
|
|
169
|
-
|
|
170
|
-
Set at least one payment key. Set both for maximum protocol compatibility and automatic fallback.
|
|
171
|
-
|
|
172
|
-
---
|
|
114
|
+
### `get_solana_token_intelligence`
|
|
173
115
|
|
|
174
|
-
|
|
116
|
+
Real time analysis of any Solana token. Pulls live data from DexScreener, Jupiter, and CoinGecko and merges it into one report. Returns an alpha score from 0 to 100, rug risk, whale activity, smart money signals, 24 hour pump probability, projected ROI ranges, and full market data. Costs $0.008 per call, paid automatically through x402 or Tempo when a key is set.
|
|
175
117
|
|
|
118
|
+
```json
|
|
119
|
+
{ "token": "BONK" }
|
|
176
120
|
```
|
|
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
|
-
└─────────────────────────────────────┘
|
|
197
|
-
```
|
|
198
|
-
|
|
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
|
-
---
|
|
202
|
-
|
|
203
|
-
## Catalog & Discovery
|
|
204
|
-
|
|
205
|
-
MPP32 maintains a federated catalog of machine-payable services indexed from three sources, so agents can find what's available across the ecosystem without scraping every provider individually.
|
|
206
|
-
|
|
207
|
-
| Source | What it is | How it's indexed |
|
|
208
|
-
|:-------|:-----------|:-----------------|
|
|
209
|
-
| **MPP32 Native** | APIs registered directly through `/build`. Payable end-to-end via the MCP server's `call_mpp32_endpoint` tool with all 5 protocols. | Provider-submitted, domain-verified, re-checked every 24h |
|
|
210
|
-
| **x402 Bazaar** | Resources discovered through the Coinbase x402 facilitator. Listing only — pay providers directly via x402. | Crawled from the Coinbase CDP discovery API |
|
|
211
|
-
| **MCP Registry** | Servers from the official Model Context Protocol registry. Listing only — install via npx/standard MCP transports. | Crawled from `registry.modelcontextprotocol.io` |
|
|
212
|
-
| **Curated** | Hand-verified providers (Firecrawl, OpenAI, Anthropic, Alchemy, CoinGecko, Exa, official MCP servers, free test endpoints, and more). | Maintained in-repo, refreshed on each catalog run |
|
|
213
121
|
|
|
214
|
-
|
|
122
|
+
M32 holders get tiered discounts (20 percent at 250k, 40 percent at 1M) the moment their wallet is verified at the agent console.
|
|
215
123
|
|
|
216
|
-
|
|
124
|
+
## How discovery works
|
|
217
125
|
|
|
218
|
-
|
|
219
|
-
|:---------|:---------|:--------|
|
|
220
|
-
| **OpenAPI 3.1** | [`/openapi.json`](https://mpp32.org/openapi.json) | Full API specification with payment metadata |
|
|
221
|
-
| **A2A Agent Card** | [`/.well-known/agent.json`](https://mpp32.org/.well-known/agent.json) | Agent-to-agent capability discovery |
|
|
222
|
-
| **MCP Config** | [`/api/mcp-config`](https://mpp32.org/api/mcp-config) | Model Context Protocol server configuration |
|
|
223
|
-
| **Service Directory** | [`/api/submissions`](https://mpp32.org/api/submissions) | Native MPP32-registered services |
|
|
224
|
-
| **Federated Catalog** | [`/api/agent/services`](https://mpp32.org/api/agent/services) | Native + curated + crawled services with filtering |
|
|
225
|
-
| **Catalog Stats** | [`/api/catalog/stats`](https://mpp32.org/api/catalog/stats) | Source breakdown and last-refresh timestamps |
|
|
126
|
+
MPP32 keeps a federated index of machine payable services so your agent can find what is out there without crawling every provider on its own. Four sources feed it.
|
|
226
127
|
|
|
227
|
-
|
|
128
|
+
| Source | What it is | Callable through this MCP |
|
|
129
|
+
|:-------|:-----------|:--------------------------|
|
|
130
|
+
| MPP32 native | APIs registered through mpp32.org/build. Verified, payable end to end. | Yes |
|
|
131
|
+
| Curated free | Hand maintained list of DexScreener, Jupiter, CoinGecko, OpenAI, and similar public APIs. | Yes when `MPP32_AGENT_KEY` is set |
|
|
132
|
+
| x402 Bazaar | Resources discovered through the Coinbase x402 facilitator. | Listing only. Pay providers directly via x402. |
|
|
133
|
+
| MCP Registry | Servers from the official Model Context Protocol registry. | No. Install via npx and run them as a separate stdio server. |
|
|
228
134
|
|
|
229
|
-
|
|
135
|
+
Every row in `list_mpp32_services` carries a callable flag so it stays obvious which slugs can be passed to `call_mpp32_endpoint`.
|
|
230
136
|
|
|
231
|
-
##
|
|
137
|
+
## Sessions for autonomous agents
|
|
232
138
|
|
|
233
|
-
For longer
|
|
139
|
+
For longer running workflows, MPP32 issues server side session keys with a 30 day expiry and full per call accounting. Sessions let an agent run inside a budget instead of negotiating payment every single call.
|
|
234
140
|
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
141
|
+
1. Create a session at [mpp32.org/agent-console](https://mpp32.org/agent-console) or by posting to `/api/agent/sessions`.
|
|
142
|
+
2. Get a key in the form `mpp32_agent_*`.
|
|
143
|
+
3. Put it in `MPP32_AGENT_KEY` in your MCP config, or send it as `X-Agent-Key` on direct API calls.
|
|
144
|
+
4. Watch spend, latency, and protocol mix live in the dashboard.
|
|
239
145
|
|
|
240
|
-
Sessions are scoped, revocable, and
|
|
146
|
+
Sessions are scoped, revocable, and rotate cleanly. The key is hashed at rest on the server, so a database leak does not surrender live credentials.
|
|
241
147
|
|
|
242
|
-
|
|
148
|
+
## How payment verification actually works
|
|
243
149
|
|
|
244
|
-
|
|
150
|
+
x402 payments are verified on chain through the Solana facilitator. Tempo payments are verified cryptographically through the mppx SDK. ACP sessions are database backed with a real checkout flow. AP2 mandates use ECDSA P-256 signature verification. AGTP uses HMAC SHA256 signed agent certificates with a server held salt so signatures cannot be forged from a public agent id alone.
|
|
245
151
|
|
|
246
|
-
|
|
152
|
+
Every protocol has its own verification path. None of them are stubbed. MPP32 never holds custody of funds. Every paid call settles directly from the caller's wallet to the provider's wallet.
|
|
247
153
|
|
|
248
|
-
|
|
154
|
+
## For API providers
|
|
249
155
|
|
|
250
|
-
|
|
251
|
-
- Endpoint health monitoring with 24-hour re-verification
|
|
252
|
-
- Discovery listing via OpenAPI, A2A, and MCP standards
|
|
253
|
-
- Analytics dashboard with query counts, revenue, and latency metrics
|
|
254
|
-
- USDC and pathUSD settlement to your wallet
|
|
156
|
+
List your endpoint once and get paid through every protocol automatically. MPP32 handles the payment negotiation, the on chain verification, the discovery listings via OpenAPI and A2A and MCP standards, the 24 hour health re check, and the analytics dashboard. Settlement lands in USDC or pathUSD straight to your wallet.
|
|
255
157
|
|
|
256
|
-
Register at
|
|
257
|
-
|
|
258
|
-
---
|
|
158
|
+
Register at [mpp32.org/build](https://mpp32.org/build).
|
|
259
159
|
|
|
260
160
|
## Links
|
|
261
161
|
|
|
@@ -263,17 +163,11 @@ Register at **[mpp32.org/build](https://mpp32.org/build)**.
|
|
|
263
163
|
|:---------|:----|
|
|
264
164
|
| Website | [mpp32.org](https://mpp32.org) |
|
|
265
165
|
| Documentation | [mpp32.org/docs](https://mpp32.org/docs) |
|
|
266
|
-
|
|
|
166
|
+
| Playground | [mpp32.org/playground](https://mpp32.org/playground) |
|
|
267
167
|
| Ecosystem | [mpp32.org/ecosystem](https://mpp32.org/ecosystem) |
|
|
268
|
-
|
|
|
168
|
+
| Agent Console | [mpp32.org/agent-console](https://mpp32.org/agent-console) |
|
|
269
169
|
| GitHub | [github.com/MPP32/MPP32](https://github.com/MPP32/MPP32) |
|
|
270
170
|
|
|
271
|
-
---
|
|
272
|
-
|
|
273
|
-
<p align="center">
|
|
274
|
-
<strong>MPP32</strong> — The payment layer for the agent economy.
|
|
275
|
-
</p>
|
|
276
|
-
|
|
277
171
|
## License
|
|
278
172
|
|
|
279
173
|
MIT
|