Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Payaion

NPM · @PAYAION/MCP · 2 COMPONENTS · SCANNED AUG 7

Agent file transfer. No API key to start; price downloads in USDC on Base.

62 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security100
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • No production dependencies, so there is no dependency health to assess. View diagnostics → Pass
Provenance & Transparency19
Schema Quality & AI Usability65
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 1594 tokens (~177/item across 9 items; 9 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
  • Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @payaion/mcp

# add to Claude Code
claude mcp add defdone-payaion -- npx -y @payaion/mcp
# add to Codex CLI
codex mcp add defdone-payaion -- npx -y @payaion/mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "defdone-payaion": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@payaion/mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add defdone-payaion --command npx --arg -y --arg @payaion/mcp
# ~/.hermes/config.yaml
mcp_servers:
  defdone-payaion:
    command: "npx"
    args: ["-y", "@payaion/mcp"]
// mcp.json
{
  "mcpServers": {
    "defdone-payaion": {
      "command": "npx",
      "args": [
        "-y",
        "@payaion/mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 7 Aug 26 +28
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • Tool coverage: unverified → 100 functional
    • MCP protocol: unverified → pass functional
    • First check of Tool coverage: 100 functional
    • First check of Schema quality: fail functional
    • First check of Schema quality: fail functional
    • First check of Schema quality: good functional
    • First check of Tool coverage: 100 functional
  • 6 Aug 26 34

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 7 Aug 2026 · Analysed npm/@payaion/[email protected]

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem npm
Dependencies 0 packages
Packages resolved 0
Tree resolution Complete
MCP tools · 9 exposed · ~1,594 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
browse_marketplace ~118

Search and browse active listings on the Payaion marketplace. Filter by keyword, category, and paginate through results. Returns listing details including title, price, file info, and unified page URL. No API key required.

NameTypeReqDescription
categorystringFilter by category.
pageintegerPage number (default 1, max 100).
pageSizeintegerResults per page (default 20, max 100).
qstringSearch query — matches title and description (max 100 chars).
NameTypeReqDescription
listingsarrayyesArray of marketplace listings
pagenumberyesCurrent page number
pageSizenumberyesResults per page
totalnumberyesTotal number of matching listings

No examples provided.

get_download_url ~110

Get a fresh shareable download URL for a previously uploaded file. The file must be in READY status. Share this URL with anyone — it works without authentication.No API key required — without one you upload as a guest (100 MB, 24-hour link); a key raises the limits and lets you sell.

NameTypeReqDescription
uploadIdstringyesUpload ID returned from upload_file or upload_from_url (e.g. up_a1b2c3d4e5f6g7h8)
NameTypeReqDescription
downloadUrlstringyesShareable download URL (works without auth)
expiresAtstringyesISO 8601 expiration timestamp
readybooleanyesTrue when the file is downloadable
uploadIdstringyesThe upload identifier

No examples provided.

get_payment_requirements ~76

Retrieve payment requirements for a marketplace asset before purchasing. Returns whether the asset is free or paid. For paid assets, includes the x402 payment requirements object that must be signed by the buyer's wallet and passed to the purchase_asset tool.

NameTypeReqDescription
uploadIdstringyesUpload ID of the marketplace asset to check payment requirements for.
NameTypeReqDescription
assetobjectyesAsset metadata.
isFreebooleanyesWhether the asset can be downloaded for free.
paymentRequirementsobjectx402 payment requirements — present only for paid assets. Sign this with your wallet and pass to purchase_asset.

No examples provided.

get_upload_status ~143

Check the processing status of a previously uploaded file. Returns the current status (PENDING_UPLOAD, UPLOADING, READY, FAILED) and whether the file is ready for download. Rarely needed — the 'transfer' tool handles polling automatically. Use this only to check on uploads that timed out or for manual status inspection.No API key required — without one you upload as a guest (100 MB, 24-hour link); a key raises the limits and lets you sell.

NameTypeReqDescription
uploadIdstringyesUpload ID returned from upload_file or upload_from_url (e.g. up_a1b2c3d4e5f6g7h8)
NameTypeReqDescription
readybooleanyesTrue when the file is fully replicated and downloadable
statusstringyesCurrent status: PENDING_UPLOAD, UPLOADING, READY, or FAILED
uploadIdstringyesThe upload identifier

No examples provided.

list_on_marketplace ~157

List an already-uploaded file on the public Payaion marketplace. The upload must be READY status and have a price set. Returns the unified page URL where buyers can view details and download. Requires the agent key owner to own the upload.

NameTypeReqDescription
categorystringOptional file category
descriptionstringyesWhat the buyer gets (40–500 characters). Required.
tagsarrayOptional tags for discoverability (max 8, alphanumeric with hyphens)
titlestringyesListing title (3–120 characters).
uploadIdstringyesUpload ID to list (e.g. up_a1b2c3d4e5f6g7h8)
NameTypeReqDescription
listedbooleanyesWhether the file was successfully listed
uploadIdstringyesUpload ID that was listed
urlstring|nullyesUnified page URL for the listing

No examples provided.

purchase_asset ~125

Finalize the purchase of a paid marketplace asset. Requires a signed x402 payment payload from the buyer's wallet. First call get_payment_requirements to obtain the payment requirements, sign them with your EVM wallet, then pass the signed payload here. Returns the purchase receipt including a directDownloadUrl — you can GET that URL with your X-Aion-Key header to download the file immediately, no extra steps needed.

NameTypeReqDescription
paymentPayloadobjectyesSigned x402 payment payload from the buyer's wallet.
uploadIdstringyesUpload ID of the marketplace asset to purchase.
NameTypeReqDescription
directDownloadUrlstringyesAuthenticated API endpoint for direct file download. GET this URL with your X-Aion-Key header to stream the file immediately after purchase.
downloadUrlstringyesPublic URL to download the purchased asset.
payerAddressstringyesWallet address that paid for the asset.
purchaseIdstringyesUnique purchase receipt ID.
statusstringyesPurchase status — "settled" on success.
txHashstring|nullyesOn-chain transaction hash, if available.

No examples provided.

transfer ~366

One-shot file transfer with optional pricing and marketplace listing. Upload a file, set a per-download price, and list on the marketplace — all in a single call. Returns a shareable download URL. Supports free transfers, paid downloads, and marketplace listings. Provide EXACTLY ONE of: 'filePath' (local stdio — zero tokens), 'url' (remote fetch), or 'content' (base64 fallback).No API key required — without one you upload as a guest (100 MB, 24-hour link); a key raises the limits and lets you sell.

NameTypeReqDescription
contentstringBase64-encoded file content (fallback when filePath and url are unavailable).
fileNamestringFilename with extension. Required for 'content', optional for 'url'.
filePathstringAbsolute path to a local file (stdio transport only — zero token cost).
idempotencyKeystringUnique key for retry-safe transfers.
listingCategorystringMarketplace category.
listingDescriptionstringWhat the buyer gets (40–500 chars). Required when listingTitle is set.
listingTagsarrayDiscovery tags (max 8, alphanumeric + dash).
listingTitlestringMarketplace listing title (3–120 chars). When set, auto-lists the file on the marketplace once ready.
mimeTypestringMIME type override (auto-detected if omitted).
pricePerDownloadnumberPrice per download in USD (e.g. 0.50). Downloaders pay in USDC. Omit or 0 for free.
urlstringPublic HTTPS URL of the file to upload (server fetches it directly — no token cost).
NameTypeReqDescription
downloadUrlstringShareable download URL (works without auth, valid 24h)
expiresAtstringISO 8601 expiration timestamp
readybooleanyesTrue when the file is downloadable right now
statusstringyesFinal status: READY, FAILED, or TIMEOUT
uploadIdstringyesUnique upload identifier (e.g. up_a1b2c3d4e5f6g7h8)
urlstringUnified page URL (includes marketplace listing context when listed)

No examples provided.

upload_file ~293

Low-level upload. Prefer the 'transfer' tool instead — it handles polling automatically. This tool returns immediately with PENDING_UPLOAD status; you must poll get_upload_status yourself. Max file size follows the account plan (Basic 500 MB / Pro 1 GB). Provide EITHER 'filePath' (local stdio only) OR 'content' (base64). Use only when you need explicit control over the upload lifecycle.No API key required — without one you upload as a guest (100 MB, 24-hour link); a key raises the limits and lets you sell.

NameTypeReqDescription
contentstringBase64-encoded file content (standard or URL-safe base64)
fileNamestringOriginal filename with extension (e.g. report.pdf). Required when using 'content', optional for 'filePath' (derived from path).
filePathstringAbsolute path to a local file. Only works when this MCP server runs locally (stdio transport). Preferred over base64 — zero tokens wasted.
idempotencyKeystringUnique key for retry-safe uploads
mimeTypestringMIME type override (auto-detected if omitted)
pricePerDownloadnumberPrice per download in USD (e.g. 0.50 or 0.00005). When set, downloaders pay this amount in USDC. Omit for free downloads.
NameTypeReqDescription
downloadUrlstringShareable download URL (works without auth, valid 24h)
expiresAtstringISO 8601 expiration timestamp
statusstringyesUpload status: PENDING_UPLOAD, UPLOADING, READY, or FAILED
uploadIdstringyesUnique upload identifier (e.g. up_a1b2c3d4e5f6g7h8)

No examples provided.

upload_from_url ~206

Low-level upload from URL. Prefer the 'transfer' tool instead — it handles polling automatically. This tool returns immediately with PENDING_UPLOAD status; you must poll get_upload_status yourself. Max file size follows the account plan (Basic 500 MB / Pro 1 GB). Private/internal URLs are blocked. Use only when you need explicit control over the upload lifecycle.No API key required — without one you upload as a guest (100 MB, 24-hour link); a key raises the limits and lets you sell.

NameTypeReqDescription
fileNamestringOptional filename override (derived from URL if omitted)
idempotencyKeystringUnique key for retry-safe uploads
pricePerDownloadnumberPrice per download in USD (e.g. 0.50 or 0.00005). When set, downloaders pay this amount in USDC. Omit for free downloads.
urlstringyesPublic HTTPS URL of the file to upload
NameTypeReqDescription
downloadUrlstringShareable download URL (works without auth, valid 24h)
expiresAtstringISO 8601 expiration timestamp
statusstringyesUpload status: PENDING_UPLOAD, UPLOADING, READY, or FAILED
uploadIdstringyesUnique upload identifier (e.g. up_a1b2c3d4e5f6g7h8)

No examples provided.