Caravan
Test-network group buying through nine buyer and seller tools.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"caravan": {
"url": "https://caravan-mcp-server.degrudv.workers.dev/mcp"
}
}
}Puntos de conexión remotos
https://caravan-mcp-server.degrudv.workers.dev/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (9)
🟢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
Esquema de entrada
{
"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
Esquema de entrada
{
"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
Esquema de entrada
{
"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
Esquema de entrada
{
"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
Esquema de entrada
{
"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
Esquema de entrada
{
"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
Esquema de entrada
{
"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
Esquema de entrada
{
"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
Esquema de entrada
{
"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
}Comunidad
Evidencia