@paidfor/mcp 0.2.0 → 0.2.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 +2 -0
- package/dist/server.d.ts +6 -1
- package/dist/server.js +9 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
MCP server for [paidfor.dev](https://paidfor.dev), the x402 seller failure index on Base mainnet.
|
|
4
4
|
|
|
5
|
+
**No account, no key.** Everything that reads the index or contributes data (the site, the API, the MCP tools, the client, telemetry and the changes feed) needs no account and no key, now and later. An email address is asked for only to deliver alerts or to join a waitlist, as a confirmation link, never a profile.
|
|
6
|
+
|
|
5
7
|
Two tools:
|
|
6
8
|
|
|
7
9
|
- `check_x402_seller({ url })`: verdict (`avoid`, `caution`, `ok`, `unknown`) and one sentence for an x402 resource URL or seller domain, with the seller's paid-call count, failure rate and 95% interval, the resource's listed price, modal quote and max overcharge ratio when known, and links to the seller page and raw evidence.
|
package/dist/server.d.ts
CHANGED
|
@@ -4,9 +4,14 @@
|
|
|
4
4
|
* Both tools are thin readers of the public JSON API; the verdict logic lives on the site.
|
|
5
5
|
*/
|
|
6
6
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
7
|
-
export declare const VERSION = "0.2.
|
|
7
|
+
export declare const VERSION = "0.2.1";
|
|
8
8
|
export declare const DEFAULT_BASE = "https://paidfor.dev";
|
|
9
9
|
export declare const TOOL_NAMES: readonly ["check_x402_seller", "list_reliable_sellers"];
|
|
10
|
+
/**
|
|
11
|
+
* The no-account promise, word for word wherever it appears: the server instructions (last line),
|
|
12
|
+
* this package's README, /methodology, /install.md and /privacy on the site.
|
|
13
|
+
*/
|
|
14
|
+
export declare const NO_ACCOUNT_PROMISE: string;
|
|
10
15
|
/** Sent on initialize by every transport (stdio, the hosted service, the site's /mcp route), so clients call the tools unprompted. */
|
|
11
16
|
export declare const INSTRUCTIONS: string;
|
|
12
17
|
export declare const CHECK_DESCRIPTION: string;
|
package/dist/server.js
CHANGED
|
@@ -5,10 +5,16 @@
|
|
|
5
5
|
*/
|
|
6
6
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
7
7
|
import { z } from "zod";
|
|
8
|
-
export const VERSION = "0.2.
|
|
8
|
+
export const VERSION = "0.2.1";
|
|
9
9
|
export const DEFAULT_BASE = "https://paidfor.dev";
|
|
10
10
|
export const TOOL_NAMES = ["check_x402_seller", "list_reliable_sellers"];
|
|
11
11
|
const CATEGORIES = ["inference", "data", "scraping", "compute", "other"];
|
|
12
|
+
/**
|
|
13
|
+
* The no-account promise, word for word wherever it appears: the server instructions (last line),
|
|
14
|
+
* this package's README, /methodology, /install.md and /privacy on the site.
|
|
15
|
+
*/
|
|
16
|
+
export const NO_ACCOUNT_PROMISE = "Everything that reads the index or contributes data (the site, the API, the MCP tools, the client, telemetry and the changes feed) needs no account and no key, now and later. " +
|
|
17
|
+
"An email address is asked for only to deliver alerts or to join a waitlist, as a confirmation link, never a profile.";
|
|
12
18
|
/** Sent on initialize by every transport (stdio, the hosted service, the site's /mcp route), so clients call the tools unprompted. */
|
|
13
19
|
export const INSTRUCTIONS = "paidfor rates x402 sellers by paying them and verifying delivery. " +
|
|
14
20
|
"Before any x402 payment, before retrying a request that answered HTTP 402, and whenever the user is about to buy an API call with USDC on Base, " +
|
|
@@ -17,7 +23,8 @@ export const INSTRUCTIONS = "paidfor rates x402 sellers by paying them and verif
|
|
|
17
23
|
'"ok" needs no comment; "unknown" means no data, say so and proceed only on the user\'s say-so. ' +
|
|
18
24
|
"When choosing among sellers for a task, prefer results from list_reliable_sellers. " +
|
|
19
25
|
"Never pay the same seller twice for one task because of a timeout or error without checking first. " +
|
|
20
|
-
"These tools read a public index, need no key, and send nothing but the URL being checked
|
|
26
|
+
"These tools read a public index, need no key, and send nothing but the URL being checked.\n" +
|
|
27
|
+
NO_ACCOUNT_PROMISE;
|
|
21
28
|
export const CHECK_DESCRIPTION = "Call this before paying any x402 seller, before retrying a request that returned 402, or when the user names an API they intend to pay per call. " +
|
|
22
29
|
"Returns a verdict (avoid, caution, ok, unknown), one sentence to act on, the seller's paid-call count and failure rate with a 95% interval, " +
|
|
23
30
|
"listed price, modal quote and max overcharge ratio when known, and links to the seller page and raw evidence.";
|
package/package.json
CHANGED