Caravan
Test-network group buying through nine buyer and seller tools.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~3,759Tokens (tool definitions)
~3.3 KBTypical response size
Significant attention impact (2.94% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"caravan": {
"url": "https://caravan-mcp-server.degrudv.workers.dev/mcp"
}
}
}Remote endpoints
https://caravan-mcp-server.degrudv.workers.dev/mcpstreamable-httpWhat it can do
Tool inventory
Tools (9)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢caravan_check_pools(intentId)
Check once whether a posted purchase intent has joined a better-priced forming pool. EXPERIMENTAL — TEST NETWORK ONLY — NOT A FINANCIAL PRODUCT OR SERVICE — NO REAL FUNDS — AS IS, NO WARRANTY, NO LIABILITY — USE AT YOUR OWN RISK
Input Schema
{
"type": "object",
"properties": {
"intentId": {
"type": "string",
"pattern": "^[0-9A-HJKMNP-TV-Z]{26}$"
}
},
"required": [
"intentId"
],
"additionalProperties": false
}🟡caravan_post_intent(intent, proof)
Post test-network demand so Caravan can aggregate it into a stronger group-buy. EXPERIMENTAL — TEST NETWORK ONLY — NOT A FINANCIAL PRODUCT OR SERVICE — NO REAL FUNDS — AS IS, NO WARRANTY, NO LIABILITY — USE AT YOUR OWN RISK
Input Schema
{
"type": "object",
"properties": {
"intent": {
"type": "object",
"properties": {
"productId": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"qty": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"unitCeiling": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"window": {
"type": "object",
"properties": {
"start": {
"type": "string",
"format": "date-time",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$",
"maxLength": 32
},
"end": {
"type": "string",
"format": "date-time",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$",
"maxLength": 32
}
},
"required": [
"start",
"end"
],
"additionalProperties": false
},
"region": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"settlementPrefs": {
"type": "array",
"minItems": 1,
"maxItems": 16,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"privacy": {
"type": "string",
"enum": [
"normal",
"private"
]
}
},
"required": [
"productId",
"qty",
"unitCeiling",
"window",
"region",
"settlementPrefs",
"privacy"
],
"additionalProperties": false
},
"proof": {
"type": "string",
"pattern": "^v1:[0-9]{4}-[0-9]{2}-[0-9]{2}:[0-9a-f]+$",
"minLength": 15,
"maxLength": 512
}
},
"required": [
"intent",
"proof"
],
"additionalProperties": false
}🟢caravan_get_match_status(intentId, intervalMs, maxAttempts)
Poll a purchase intent until it matches or returns explainable failure reasons. EXPERIMENTAL — TEST NETWORK ONLY — NOT A FINANCIAL PRODUCT OR SERVICE — NO REAL FUNDS — AS IS, NO WARRANTY, NO LIABILITY — USE AT YOUR OWN RISK
Input Schema
{
"type": "object",
"properties": {
"intentId": {
"type": "string",
"pattern": "^[0-9A-HJKMNP-TV-Z]{26}$"
},
"intervalMs": {
"type": "integer",
"minimum": 0,
"maximum": 3000
},
"maxAttempts": {
"type": "integer",
"minimum": 1,
"maximum": 10
}
},
"required": [
"intentId"
],
"additionalProperties": false
}🔴caravan_pay_reveal(manifestId, poolId, payment)
Use a Phase-0 payment rail to reveal the matched test-network manifest. EXPERIMENTAL — TEST NETWORK ONLY — NOT A FINANCIAL PRODUCT OR SERVICE — NO REAL FUNDS — AS IS, NO WARRANTY, NO LIABILITY — USE AT YOUR OWN RISK
Input Schema
{
"type": "object",
"properties": {
"manifestId": {
"type": "string",
"pattern": "^[0-9A-HJKMNP-TV-Z]{26}$"
},
"poolId": {
"type": "string",
"pattern": "^[0-9A-HJKMNP-TV-Z]{26}$"
},
"payment": {
"type": "object",
"properties": {
"rail": {
"type": "string",
"enum": [
"mock",
"x402-testnet",
"credits"
]
},
"paymentSignature": {
"type": "string",
"minLength": 4,
"maxLength": 24000,
"pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
}
},
"required": [
"rail",
"paymentSignature"
],
"additionalProperties": false
}
},
"required": [
"payment"
],
"additionalProperties": false,
"oneOf": [
{
"required": [
"manifestId"
],
"not": {
"required": [
"poolId"
]
}
},
{
"required": [
"poolId"
],
"not": {
"required": [
"manifestId"
]
}
}
]
}🔴caravan_commit(mode, commitment, signature, publish, bond)
Sign or bond a test-network purchase commitment without exposing a private key to the server. EXPERIMENTAL — TEST NETWORK ONLY — NOT A FINANCIAL PRODUCT OR SERVICE — NO REAL FUNDS — AS IS, NO WARRANTY, NO LIABILITY — USE AT YOUR OWN RISK
Input Schema
{
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"bond",
"sign"
]
},
"commitment": {
"type": "object",
"properties": {
"manifestHash": {
"type": "string",
"pattern": "^0x[0-9a-f]{64}$"
},
"poolId": {
"type": "string",
"pattern": "^[0-9A-HJKMNP-TV-Z]{26}$"
},
"buyer": {
"type": "string",
"pattern": "^0x(?!0{40}$)[0-9a-fA-F]{40}$"
},
"seller": {
"type": "string",
"pattern": "^0x(?!0{40}$)[0-9a-fA-F]{40}$"
},
"productId": {
"type": "string",
"minLength": 1,
"maxLength": 256,
"pattern": "^(?:\\S|\\S[\\s\\S]*\\S)$"
},
"qty": {
"type": "string",
"pattern": "^[1-9][0-9]{0,77}$"
},
"unitPrice": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})$"
},
"settlementMethod": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^(?:\\S|\\S[\\s\\S]*\\S)$"
},
"expiry": {
"type": "string",
"pattern": "^[1-9][0-9]{0,77}$"
},
"termsHash": {
"type": "string",
"pattern": "^0x[0-9a-f]{64}$"
}
},
"required": [
"manifestHash",
"poolId",
"buyer",
"seller",
"productId",
"qty",
"unitPrice",
"settlementMethod",
"expiry",
"termsHash"
],
"additionalProperties": false
},
"signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}$"
},
"publish": {
"type": "boolean"
},
"bond": {
"type": "object",
"properties": {
"deploy": {
"type": "object",
"properties": {
"chainId": {
"type": "integer",
"const": 84532
},
"token": {
"type": "string",
"pattern": "^0x(?!0{40}$)[0-9a-fA-F]{40}$"
},
"manifestHash": {
"type": "string",
"pattern": "^0x[0-9a-f]{64}$"
},
"participants": {
"type": "array",
"minItems": 2,
"maxItems": 32,
"items": {
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x(?!0{40}$)[0-9a-fA-F]{40}$"
},
"role": {
"type": "string",
"enum": [
"buyer",
"seller"
]
},
"requiredAct": {
"type": "string",
"enum": [
"deposit-settlement",
"post-countersign-hash"
]
},
"bondAmountUSDC6": {
"type": "string",
"pattern": "^[1-9][0-9]{0,77}$"
},
"depositDeadlineUnixSeconds": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,19})$"
},
"performDeadlineUnixSeconds": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,19})$"
}
},
"required": [
"address",
"role",
"requiredAct",
"bondAmountUSDC6",
"depositDeadlineUnixSeconds",
"performDeadlineUnixSeconds"
],
"additionalProperties": false
}
}
},
"required": [
"chainId",
"token",
"manifestHash",
"participants"
],
"additionalProperties": false
},
"deposit": {
"type": "object",
"properties": {
"bondAddress": {
"type": "string",
"pattern": "^0x(?!0{40}$)[0-9a-fA-F]{40}$"
},
"participant": {
"type": "string",
"pattern": "^0x(?!0{40}$)[0-9a-fA-F]{40}$"
}
},
"required": [
"bondAddress",
"participant"
],
"additionalProperties": false
},
"evidence": {
"type": "object",
"properties": {
"bondAddress": {
"type": "string",
"pattern": "^0x(?!0{40}$)[0-9a-fA-F]{40}$"
},
"deploymentTransactionHash": {
"type": "string",
"pattern": "^0x[0-9a-f]{64}$"
},
"depositTransactionHash": {
"type": "string",
"pattern": "^0x[0-9a-f]{64}$"
}
},
"required": [
"bondAddress",
"deploymentTransactionHash",
"depositTransactionHash"
],
"additionalProperties": false
}
},
"required": [
"deploy",
"deposit",
"evidence"
],
"additionalProperties": false
}
},
"required": [
"mode",
"commitment",
"signature"
],
"additionalProperties": false,
"oneOf": [
{
"properties": {
"mode": {
"const": "sign"
}
},
"required": [
"mode",
"commitment",
"signature"
],
"not": {
"required": [
"bond"
]
}
},
{
"properties": {
"mode": {
"const": "bond"
},
"publish": {
"const": true
}
},
"required": [
"mode",
"commitment",
"signature",
"bond"
]
}
]
}⚪caravan_attest(attestation, signature)
Co-sign a test-network pool outcome to build portable completion evidence. EXPERIMENTAL — TEST NETWORK ONLY — NOT A FINANCIAL PRODUCT OR SERVICE — NO REAL FUNDS — AS IS, NO WARRANTY, NO LIABILITY — USE AT YOUR OWN RISK
Input Schema
{
"type": "object",
"properties": {
"attestation": {
"type": "object",
"properties": {
"manifestHash": {
"type": "string",
"pattern": "^0x[0-9a-f]{64}$"
},
"poolId": {
"type": "string",
"pattern": "^[0-9A-HJKMNP-TV-Z]{26}$"
},
"role": {
"type": "string",
"enum": [
"buyer",
"seller"
]
},
"outcome": {
"type": "string",
"enum": [
"completed",
"seller_default",
"buyer_default"
]
},
"realizedUnitPrice": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})$",
"not": {
"const": "115792089237316195423570985008687907853269984665640564039457584007913129639935"
}
}
},
"required": [
"manifestHash",
"poolId",
"role",
"outcome"
],
"additionalProperties": false,
"oneOf": [
{
"properties": {
"outcome": {
"const": "completed"
}
}
},
{
"properties": {
"outcome": {
"enum": [
"seller_default",
"buyer_default"
]
}
},
"not": {
"required": [
"realizedUnitPrice"
]
}
}
]
},
"signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}$"
}
},
"required": [
"attestation",
"signature"
],
"additionalProperties": false
}🟡caravan_post_offer(offer)
Publish test-network quantity tiers so verified capacity can compete for aggregated demand. EXPERIMENTAL — TEST NETWORK ONLY — NOT A FINANCIAL PRODUCT OR SERVICE — NO REAL FUNDS — AS IS, NO WARRANTY, NO LIABILITY — USE AT YOUR OWN RISK
Input Schema
{
"type": "object",
"properties": {
"offer": {
"type": "object",
"properties": {
"sellerId": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"productId": {
"type": "string",
"pattern": "^(?:GTIN:(?:[0-9]{8}|[0-9]{12}|[0-9]{13}|[0-9]{14})|MPN:[A-Za-z0-9][A-Za-z0-9._/-]{0,127}|spec-hash:[a-f0-9]{64})$",
"minLength": 1,
"maxLength": 138
},
"tiers": {
"type": "array",
"minItems": 1,
"maxItems": 64,
"items": {
"type": "object",
"properties": {
"minQty": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"unitPrice": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"minQty",
"unitPrice"
],
"additionalProperties": false
}
},
"expiry": {
"type": "string",
"format": "date-time",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(?:\\.[0-9]{3})?Z$",
"maxLength": 32
},
"maxOutstandingQty": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"minCommittedQtyPerBindingTier": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"regions": {
"type": "array",
"minItems": 1,
"maxItems": 64,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"substitutionPolicy": {
"type": "string",
"enum": [
"none",
"equivalent",
"seller-approved"
]
},
"taxShippingExclusions": {
"type": "array",
"maxItems": 64,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"settlementMethods": {
"type": "array",
"minItems": 1,
"maxItems": 32,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"sellerBondLevel": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"bindingFlag": {
"type": "string",
"enum": [
"binding",
"indicative"
]
}
},
"required": [
"sellerId",
"productId",
"tiers",
"expiry",
"maxOutstandingQty",
"minCommittedQtyPerBindingTier",
"regions",
"substitutionPolicy",
"taxShippingExclusions",
"settlementMethods",
"sellerBondLevel",
"bindingFlag"
],
"additionalProperties": false
}
},
"required": [
"offer"
],
"additionalProperties": false
}⚪caravan_seller_onboard(card, domainOrigin)
Link a seller AgentCard and HTTPS domain proof before offering capacity. EXPERIMENTAL — TEST NETWORK ONLY — NOT A FINANCIAL PRODUCT OR SERVICE — NO REAL FUNDS — AS IS, NO WARRANTY, NO LIABILITY — USE AT YOUR OWN RISK
Input Schema
{
"type": "object",
"properties": {
"card": {
"type": "object",
"properties": {
"version": {
"type": "string",
"const": "1.0"
},
"name": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"maxLength": 128
},
"description": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"maxLength": 2048
},
"skills": {
"type": "array",
"maxItems": 64,
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]+$",
"minLength": 1,
"maxLength": 128
},
"name": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"maxLength": 128
},
"description": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"maxLength": 1024
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"endpoints": {
"type": "array",
"minItems": 1,
"maxItems": 16,
"items": {
"type": "object",
"properties": {
"protocol": {
"type": "string",
"enum": [
"a2a",
"mcp",
"https"
]
},
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"maxLength": 2048
}
},
"required": [
"protocol",
"url"
],
"additionalProperties": false
}
},
"disclaimer": {
"type": "string",
"const": "EXPERIMENTAL — TEST NETWORK ONLY — NOT A FINANCIAL PRODUCT OR SERVICE — NO REAL FUNDS — AS IS, NO WARRANTY, NO LIABILITY — USE AT YOUR OWN RISK"
},
"erc8004": {
"type": "object",
"properties": {
"chainId": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"registryAddress": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"tokenId": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})$"
}
},
"required": [
"chainId",
"registryAddress",
"tokenId"
],
"additionalProperties": false
}
},
"required": [
"version",
"name",
"skills",
"endpoints",
"disclaimer"
],
"additionalProperties": false
},
"domainOrigin": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"maxLength": 512
}
},
"required": [
"card",
"domainOrigin"
],
"additionalProperties": false
}🟢caravan_price_history(productId, limit, cursor)
Compare privacy-safe historical discounts before deciding whether to join a pool. EXPERIMENTAL — TEST NETWORK ONLY — NOT A FINANCIAL PRODUCT OR SERVICE — NO REAL FUNDS — AS IS, NO WARRANTY, NO LIABILITY — USE AT YOUR OWN RISK
Input Schema
{
"type": "object",
"properties": {
"productId": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"cursor": {
"type": "string",
"pattern": "^cph_[0-9a-f]{64}$"
}
},
"required": [
"productId"
],
"additionalProperties": false
}Community
Evidence
Recent observations
verifiedversion not recorded9 tools
verifiedversion not recorded9 tools