io.github.andysalvo/supership-scan
Buy any x402 API or data on Base, Solana, Polygon. No wallet on the seller's chain. For AI agents.
Open source Open in the app JSON README (API)
About
Buy any x402 API or data on Base, Solana, Polygon. No wallet on the seller's chain. For AI agents.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- andysalvo
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 2.0.2
- Forks
- 1
- Open pull requests
- 1
- Last push
- 2026-06-04T18:09:45Z
- Repository state
- arquivado
- Language
- JavaScript
- License
- NOASSERTION
- Added
- 2026-08-29 03:02:25
- Updated
- 2026-08-29 03:02:25
- Origin id
io.github.andysalvo/supership-scan
README
# supership
The search engine and clearing house for the agent economy. Built by [Crest Deployment Systems](https://crestsystems.ai).
supership indexes the entire x402 economy -- 52,000 services -- so an AI agent can **find** the right data and **fetch** it with a receipt. Reading the menu is free. Fetching through supership returns the goods plus a **signed delivery receipt**: proof of what you got, from where, settled on-chain. That is the part going direct can never give you.
## Install
```bash
npm install -g supership-scan
```
> Published on npm as `supership-scan` (the original name; kept for install continuity).
Requires Node.js 18+.
## MCP server
```bash
npx -y -p supership-scan supership-mcp
```
Or wire it into any MCP client (Claude Code, Cursor, Windsurf):
```json
{
"mcpServers": {
"supership": {
"command": "npx",
"args": ["-y", "-p", "supership-scan", "supership-mcp"]
}
}
}
```
### Tools
| Tool | What it does |
|------|--------------|
| `manifest` | Search the whole x402 economy (52,000 services) for what you need. Ranked by **distinct payers** -- real adoption, not call counts. Free. |
| `procure` | Fetch any source. supership fronts payment across any chain, delivers the goods, and returns a **signed receipt**. No wallet needed on the seller's chain. First runs free. |
| `list_catalog` | Browse a curated catalog of procurable sources. |
| `scan_directory` | Scan a local directory for security issues before you ship. |
## Free menu, paid kitchen
- **The menu is free.** `manifest` shows the real market: every relevant source, free or paid, ranked by who actually paid for it. That ranking is the part you cannot compute yourself -- it takes the whole index and the payment history.
- **The kitchen is the product.** When you `procure`, supership crosses to the source (on whatever chain it lives), pays, takes delivery, and hands you the goods **plus a signed delivery receipt** -- an Ed25519 record of what was delivered (source, SHA-256 of the goods, settlement tx, timestamp), verifiable at `/api/pubkey`. That receipt is the provenance going direct cannot give you.
## HTTP API
| Endpoint | Price | Description |
|----------|-------|-------------|
| `/manifest?need=` | Free | Search the economy; ranked by real payers |
| `/catalog` | Free | Curated procurable sources |
| `/sample?url=` | Free | Fetch one source on the house -- with a signed receipt |
| `/procure?url=` | per-call | Fetch any source; goods + signed receipt |
API base: `https://supership.crestsystems.ai`
Discovery: [agent.json](https://supership.crestsystems.ai/.well-known/agent.json) | [llms.txt](https://supership.crestsystems.ai/llms.txt) | [OpenAPI](https://supership.crestsystems.ai/openapi.json)
## What supership does not do
- It does not sell the data. It indexes the market and delivers what you ask for, with a receipt.
- It does not hold your funds. The MCP server holds no keys and moves no money locally.
- It does not give investment advice.
## License
Apache 2.0.