Tool Reference
Complete reference for all PRIV MCP server tools with input schemas and examples
Tool Reference
The PRIV MCP server exposes tools, resources, and prompts. This page documents all available tools.
Phase 1 Tools (Read-Only)
search_marketplace
Search the PRIV data marketplace for available datasets.
Input Schema:
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Search keyword |
category | string | No | Data category (browsing, social, commerce, location, content) |
data_type | string | No | Type of data (behavioral, demographic, transactional) |
min_price | number | No | Minimum price in PRIV tokens |
max_price | number | No | Maximum price in PRIV tokens |
page | number | No | Page number (default: 1) |
per_page | number | No | Results per page (default: 20, max: 50) |
get_listing_details
Get detailed information about a specific marketplace listing, including schema and sample data.
Input Schema:
| Parameter | Type | Required | Description |
|---|---|---|---|
listing_id | string | Yes | The listing ID to retrieve |
browse_bounties
Browse open data bounties on the PRIV Bounty Board.
Input Schema:
| Parameter | Type | Required | Description |
|---|---|---|---|
category | string | No | Filter by data category |
status | enum | No | open, in_progress, completed, expired |
min_reward | number | No | Minimum reward in PRIV tokens |
sort_by | enum | No | reward, deadline, created_at (default) |
page | number | No | Page number (default: 1) |
get_bounty_details
Get detailed information about a specific bounty.
Input Schema:
| Parameter | Type | Required | Description |
|---|---|---|---|
bounty_id | string | Yes | The bounty ID to retrieve |
get_available_tasks
List available AI labeling tasks.
Input Schema:
| Parameter | Type | Required | Description |
|---|---|---|---|
task_type | string | No | Filter by type (image_classification, text_annotation, etc.) |
difficulty | enum | No | easy, medium, hard |
min_reward | number | No | Minimum reward in PRIV tokens |
page | number | No | Page number (default: 1) |
get_task_details
Get detailed information about a specific labeling task.
Input Schema:
| Parameter | Type | Required | Description |
|---|---|---|---|
task_id | string | Yes | The task ID to retrieve |
check_balance
Check the authenticated user's PRIV token balance, including staked and pending rewards.
Input Schema: None (uses authenticated API key)
get_earnings_history
View earnings history from data contributions, bounty rewards, staking, and labeling tasks.
Input Schema:
| Parameter | Type | Required | Description |
|---|---|---|---|
source | enum | No | contribution, bounty, staking, labeling, referral |
page | number | No | Page number (default: 1) |
per_page | number | No | Results per page (default: 20) |
get_contribution_stats
Get data contribution statistics including counts by status and category.
Input Schema:
| Parameter | Type | Required | Description |
|---|---|---|---|
period | enum | No | 7d, 30d, 90d, all (default: 30d) |
search_docs
Search PRIV documentation by keyword.
Input Schema:
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search keyword or phrase |
category | enum | No | guide, product, token, developer, compliance |
Resources
Resources provide read-only data that agents can access without tool calls.
| URI | Description |
|---|---|
priv://marketplace/categories | Available data categories with descriptions |
priv://presale/stages | Current presale stage information and pricing |
priv://token/stats | Token supply, burn stats, and fee configuration |
priv://platform/health | Platform health and service status |
Prompts
Prompts are reusable templates that guide agents through common workflows.
| Prompt | Description | Parameters |
|---|---|---|
find-data | Guide agent to describe data needs and match to listings | data_need (string) |
evaluate-listing | Template for quality assessment of a listing | listing_id (string) |
integration-guide | Step-by-step SDK/MCP setup for a use case | use_case (string) |
Phase 2+ Tools (Coming)
| Tool | Phase | Description |
|---|---|---|
purchase_data | 2 | Buy a marketplace listing with PRIV tokens |
fund_bounty | 2 | Create and fund a data bounty |
claim_earnings | 2 | Claim pending PRIV earnings |
contribute_data | 3 | Upload data contributions |
manage_consent | 3 | Update consent preferences |
create_subscription | 4 | Subscribe to data feeds |
bulk_purchase | 5 | Purchase multiple listings |