agentvee-mcp 0.1.4

MCP server for AgentVee (testnet / pre-1.0) — file uploads, marketplace listings, and paid downloads for AI agents. Currently targeting the develop environment for integration testing before 1.0 release.

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

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

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

   {
     "mcpServers": {
       "agentvee": {
         "command": "uvx",
         "args": ["agentvee-mcp"],
         "env": {
           "AGENTVEE_API_KEY": "your-api-key-here"
         }
       }
     }
   }
   

   Or with pip:

   {
     "mcpServers": {
       "agentvee": {
         "command": "python",
         "args": ["-m", "agentvee_mcp"],
         "env": {
           "AGENTVEE_API_KEY": "your-api-key-here"
         }
       }
     }
   }
   

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

Installation

pip install agentvee-mcp

Or with uv:

uvx agentvee-mcp --help

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

After upload, list on the marketplace with list_on_marketplace:

uploadId: "abc123"
title: "Dataset Q1 2026"
description: "Cleaned sales data"
category: "datasets"  # reports | datasets | code | media | models | prompts | other
tags: ["sales", "q1"]

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:

• Cursor
• Claude Desktop
• Cline
• Continue

CLI

agentvee-mcp --help
agentvee-mcp --version

HTTP Transport

agentvee-mcp-http

Or:

python -m agentvee_mcp.http

Also Available

• Node.js: npx -y @agentvee/mcp (npm)

License

MIT