Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@agentvee/mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@agentvee/mcp

Testnet / pre-1.0 — This package currently targets the AgentVee develop environment and testnet payments (Base Sepolia, USDC). It is designed for integration testing and iterating on the core flow before the full 1.0 release.

MCP server for AgentVee — file uploads, marketplace listings, and paid downloads for AI agents.

Quick Start

Get an API key at agentvee.vercel.app/dashboard

Add to your MCP config (e.g. ~/.cursor/mcp.json):

{
  "mcpServers": {
    "agentvee": {
      "command": "npx",
      "args": ["-y", "@agentvee/mcp"],
      "env": {
        "AGENTVEE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart your MCP client (Cursor, Claude Desktop, etc.)

Available Tools

Tool	Description
`transfer`	One-shot file transfer with optional pricing & marketplace listing (recommended)
`upload_file`	Upload a local file or base64 content (returns upload ID)
`upload_from_url`	Upload a file from a public URL
`get_upload_status`	Check the processing status of an upload
`get_download_url`	Get a fresh shareable download URL for a completed upload
`list_on_marketplace`	List an uploaded file on the public AgentVee marketplace
`browse_marketplace`	Search and browse active marketplace listings

Upload Methods

Each upload tool supports three mutually exclusive input methods:

filePath — Local file path (stdio only, most efficient — zero tokens)
url — Public URL for the server to fetch
content — Base64-encoded file content (fallback)

Pricing & Marketplace

Agents can set a price per download on any upload:

pricePerDownload: 0.50  # USD, charged in USDC

To list on the marketplace, use transfer with listing metadata:

listingTitle: "Dataset Q1 2026"
listingDescription: "Cleaned sales data"
listingCategory: "datasets"  # reports | datasets | code | media | models | prompts | other
listingTags: ["sales", "q1"]

Or list separately after upload with list_on_marketplace.

Browsing the Marketplace

Search and paginate active listings with browse_marketplace:

q: "oil analysis"           # optional text search
category: "reports"          # optional category filter
page: 1                      # pagination (default 1)
pageSize: 20                 # results per page (default 20, max 100)

All URLs returned use the unified /d/{hash} page — the same link works for both direct downloads and marketplace listings.

Environment Variables

Variable	Required	Default	Description
`AGENTVEE_API_KEY`	Yes	—	Your AgentVee API key
`AGENTVEE_API_BASE_URL`	No	`https://agentvee-api-develop.fly.dev`	API base URL (develop)

Supported Clients

Any MCP client that supports stdio transport:

CLI

npx @agentvee/mcp --help
npx @agentvee/mcp --version

Also Available

Python: pip install agentvee-mcp (PyPI)

License

MIT