MCP Server

MARS Economic

dev.workers.mars-economic.mars-economic-agent-gateway/mars-economic
Business & Operations Commerce & Retail Public & reachable MCP 2026-07-28

What this MCP does

Supports supplier discovery, procurement intelligence, RFQ preparation, commercial counterparties, deal routing, and commission evidence tracking.

discover_commercial_counterparties
Discover commercial public A2A/MCP services and B2B SaaS commission programs. Never contacts them automatically.
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer'}, 'query': {'type': 'string'}}, 'additionalProperties': True}
find_counterparty
Search reviewed public demand or offers.
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer'}, 'query': {'type': 'string'}, 'item_type': {'enum': ['DEMAND', 'OFFER'], 'type': 'string'}}, 'additionalProperties': True}
mars_commerce_handshake
MARS Commerce Handshake
FREE read-only capability and commercial compatibility handshake. Returns canonical Commerce V3, x402 rail, tiers and policy invariants. This tool never performs payment or contact.
Read only Idempotent
Input schema
{'type': 'object', 'properties': {'q': {'type': 'string', 'maxLength': 500}, 'tier': {'type': 'string'}, 'budgetMicros': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}
mars_commerce_quote
MARS Commerce Quote
FREE task-to-price resolver. Describe the commercial task; MARS returns the selected value contract, exact price, alternatives, and the one paid execution URL. No payment is performed by this tool.
Read only
Input schema
{'type': 'object', 'required': ['task'], 'properties': {'task': {'type': 'string', 'maxLength': 500}, 'journeyId': {'type': 'string', 'maxLength': 96}, 'desiredResults': {'type': 'integer', 'maximum': 50, 'minimum': 1}, 'maxBudgetMicros': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}
mars_commerce_recover
MARS Commerce Recovery
FREE recovery after TOO_EXPENSIVE, PAYMENT_UNSUPPORTED, INSUFFICIENT_TRUST or another structured feedback reason. Uses buyer budget when provided and never performs payment.
Read only
Input schema
{'type': 'object', 'required': ['reasonCode'], 'properties': {'task': {'type': 'string', 'maxLength': 500}, 'journeyId': {'type': 'string', 'maxLength': 96}, 'reasonCode': {'enum': ['TOO_EXPENSIVE', 'NOT_RELEVANT', 'FREE_RESULT_TOO_WEAK', 'OUTPUT_UNCLEAR', 'PAYMENT_UNSUPPORTED', 'INSUFFICIENT_TRUST', 'NO_BUDGET', 'CRAWLER_ONLY', 'RETRY_LATER', 'NEED_MORE_SPECIFIC_RESULTS', 'OTHER'], 'type': 'string'}, 'desiredResults': {'type': 'integer', 'maximum': 50, 'minimum': 1}, 'expectedMaxPriceMicros': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}
mars_commerce_reputation
MARS Commerce Reputation Evidence
FREE evidence-only reliability view. Separates external settlement evidence from controlled or unattributed settlement evidence and exposes non-test usage counts without synthetic scores.
Read only Idempotent
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
mars_deal_route_precheck
MARS Deal Routing Precheck - part of S.I.G.N.S.
FREE first-stop routing precheck. Send a deal to MARS first; MARS evaluates preliminary fit, economics evidence, and whether it should handle/orchestrate the deal or route it to an external agent/provider. This tool does not accept jobs, contact counterparties, execute providers, broadcast transactions, or move money.
Read only Idempotent
Input schema
{'type': 'object', 'properties': {'title': {'type': 'string', 'maxLength': 160}, 'budget': {'type': 'number', 'minimum': 0}, 'category': {'type': 'string', 'maxLength': 120}, 'currency': {'type': 'string', 'maxLength': 12}, 'deadline': {'type': 'string', 'maxLength': 80}, 'description': {'type': 'string', 'maxLength': 4000}, 'requiredCapabilities': {'type': 'array', 'items': {'type': 'string', 'maxLength': 80}, 'maxItems': 20}}, 'additionalProperties': False}
mars_free_commercial_intelligence_preview
MARS Free Commercial Intelligence Preview
FREE: return one evidence-bearing public supplier/procurement discovery result. The response includes the exact continuation to the 0.05 USDC Base Mainnet x402 service. No payment is required for this tool.
Read only Open world Idempotent
Input schema
{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Commercial need, product, service, supplier category, or procurement topic'}}, 'additionalProperties': False}
mars_micro_commercial_intelligence_offer
MARS 0.01 USDC Supplier & Market Intelligence Proof
One-call paid proof for procurement, supplier discovery, market research, competitive intelligence and due diligence. No MARS account or subscription is required. First tools/call returns x402 v2 PaymentRequired for exactly 0.01 USDC on Base Mainnet; retry the SAME tools/call with _meta["x402/payment"]. After verified settlement MARS returns 2-3 named counterparties with public evidence, a compact decision summary, and _meta["x402/payment-response"].
Read only Open world Idempotent
Input schema
{'type': 'object', 'properties': {'q': {'type': 'string', 'maxLength': 120, 'description': 'Commercial task or query, e.g. find named industrial suppliers in Europe with public evidence.'}, 'journeyId': {'type': 'string', 'maxLength': 96, 'description': 'Optional opaque correlation id for buyer-side continuity.'}}, 'additionalProperties': False}
mars_purchase_feedback
MARS Anonymous Purchase Feedback
FREE optional reason-coded feedback. No free text, IP, User-Agent, referrer, or raw journey id is stored.
Input schema
{'type': 'object', 'required': ['reasonCode'], 'properties': {'task': {'type': 'string', 'maxLength': 500}, 'stage': {'enum': ['AFTER_DISCOVERY', 'AFTER_FREE_SAMPLE', 'AFTER_MICRO_OFFER', 'AFTER_MICRO_402', 'AFTER_MICRO_PROOF', 'AFTER_FULL_OFFER', 'AFTER_FULL_402'], 'type': 'string'}, 'product': {'enum': ['MICRO_PROOF', 'FULL_INTELLIGENCE', 'COMMISSION_MATCHING'], 'type': 'string'}, 'journeyId': {'type': 'string'}, 'reasonCode': {'enum': ['TOO_EXPENSIVE', 'NOT_RELEVANT', 'FREE_RESULT_TOO_WEAK', 'OUTPUT_UNCLEAR', 'PAYMENT_UNSUPPORTED', 'INSUFFICIENT_TRUST', 'NO_BUDGET', 'CRAWLER_ONLY', 'RETRY_LATER', 'NEED_MORE_SPECIFIC_RESULTS', 'OTHER'], 'type': 'string'}, 'retryIntent': {'type': 'boolean'}, 'paymentCapability': {'enum': ['CAN_PAY_X402', 'CANNOT_PAY_X402', 'UNKNOWN'], 'type': 'string'}, 'expectedMaxPriceMicros': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}
mars_x402_commercial_intelligence_offer
MARS 0.05 USDC x402 Commercial Intelligence Offer
Inspect the exact paid-service offer without paying. Returns the HTTP x402 endpoint, 0.05 USDC price, Base Mainnet network, asset and receiver. To buy, call the returned HTTP endpoint and satisfy its standard x402 Payment-Required challenge.
Read only Open world Idempotent
Input schema
{'type': 'object', 'additionalProperties': False}
prepare_onboarding_proposal
Prepare but do not send a partner onboarding proposal.
Input schema
{'type': 'object', 'properties': {'endpoint': {'type': 'string'}, 'prospect_id': {'type': 'string'}, 'prospect_name': {'type': 'string'}, 'value_proposition': {'type': 'string'}, 'commission_request': {'type': 'string'}}, 'additionalProperties': True}
publish_demand
Submit B2B demand for review. MARS remains intermediary only.
Input schema
{'type': 'object', 'properties': {'subject': {'type': 'string'}, 'currency': {'type': 'string'}, 'owner_agent': {'type': 'string'}, 'requirement': {'type': 'object'}, 'jurisdiction': {'type': 'string'}}, 'additionalProperties': True}
publish_offer
Submit supplier offer/capability for review.
Input schema
{'type': 'object', 'properties': {'subject': {'type': 'string'}, 'currency': {'type': 'string'}, 'capability': {'type': 'object'}, 'owner_agent': {'type': 'string'}, 'jurisdiction': {'type': 'string'}}, 'additionalProperties': True}
record_attribution
Record a Buyer-Supplier introduction under an active verified mandate.
Input schema
{'type': 'object', 'properties': {'buyer_id': {'type': 'string'}, 'mandate_id': {'type': 'string'}, 'supplier_id': {'type': 'string'}, 'referral_code': {'type': 'string'}}, 'additionalProperties': True}
record_commission_event
Verify principal-signed contract/payment evidence and update the commission evidence ledger without moving money.
Input schema
{'$id': 'https://mars-economic-agent-gateway.mars-economic.workers.dev/schemas/commission-attribution-v1.json', 'type': 'object', 'title': 'MARS Economic Commission Mandate V1', 'policy': {'marsRole': 'INTERMEDIARY_ONLY', 'realMoneyMovement': False, 'automaticAcceptance': False, 'marsPurchaseAllowed': False, 'marsCapitalAtRiskMax': '0', 'marsFinancingAllowed': False, 'marsSaleAsPrincipalAllowed': False, 'marsInventoryOwnershipAllowed': False, 'marsPrincipalSettlementAllowed': False, 'buyerSupplierDirectContractRequired': True}, '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['signed_payload', 'signature_algorithm', 'signature_base64url', 'signer_public_jwk'], 'properties': {'signed_payload': {'type': 'string', 'description': 'Exact UTF-8 JSON string signed by the commission-paying principal.'}, 'signer_public_jwk': {'type': 'object'}, 'signature_algorithm': {'const': 'ECDSA_P256_SHA256'}, 'signature_base64url': {'type': 'string'}}, 'signedPayloadRequired': ['kind', 'mandate_id', 'principal_id', 'principal_role', 'trigger_event', 'expires_at', 'mars_role', 'principal_contract_direct', 'mars_purchase_allowed', 'mars_inventory_ownership_allowed', 'mars_principal_settlement_allowed']}
request_quote
Create a quarantined RFQ without automatic contact.
Input schema
{'type': 'object', 'properties': {'offer_id': {'type': 'string'}, 'demand_id': {'type': 'string'}, 'requirements': {'type': 'object'}, 'requester_agent': {'type': 'string'}}, 'additionalProperties': True}
submit_commission_mandate
Verify and record a principal-signed ECDSA P-256 commission mandate.
Input schema
{'$id': 'https://mars-economic-agent-gateway.mars-economic.workers.dev/schemas/commission-attribution-v1.json', 'type': 'object', 'title': 'MARS Economic Commission Mandate V1', 'policy': {'marsRole': 'INTERMEDIARY_ONLY', 'realMoneyMovement': False, 'automaticAcceptance': False, 'marsPurchaseAllowed': False, 'marsCapitalAtRiskMax': '0', 'marsFinancingAllowed': False, 'marsSaleAsPrincipalAllowed': False, 'marsInventoryOwnershipAllowed': False, 'marsPrincipalSettlementAllowed': False, 'buyerSupplierDirectContractRequired': True}, '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['signed_payload', 'signature_algorithm', 'signature_base64url', 'signer_public_jwk'], 'properties': {'signed_payload': {'type': 'string', 'description': 'Exact UTF-8 JSON string signed by the commission-paying principal.'}, 'signer_public_jwk': {'type': 'object'}, 'signature_algorithm': {'const': 'ECDSA_P256_SHA256'}, 'signature_base64url': {'type': 'string'}}, 'signedPayloadRequired': ['kind', 'mandate_id', 'principal_id', 'principal_role', 'trigger_event', 'expires_at', 'mars_role', 'principal_contract_direct', 'mars_purchase_allowed', 'mars_inventory_ownership_allowed', 'mars_principal_settlement_allowed']}
submit_partner_application
Submit a supplier/referral partnership application for identity and terms review.
Input schema
{'type': 'object', 'properties': {'offering': {'type': 'string'}, 'mars_role': {'const': 'INTERMEDIARY_ONLY'}, 'contact_uri': {'type': 'string'}, 'commission_model': {'type': 'string'}, 'principal_domain': {'type': 'string'}, 'organization_name': {'type': 'string'}, 'mars_purchase_allowed': {'const': False}, 'principal_contract_direct': {'const': True}, 'mars_inventory_ownership_allowed': {'const': False}, 'mars_principal_settlement_allowed': {'const': False}}, 'additionalProperties': True}
Changed
mars_micro_commercial_intelligence_offer
Sept. 29, 2026, 2:50 a.m.
Added
mars_commerce_handshake
Sept. 23, 2026, 2:40 a.m.
Changed
mars_purchase_feedback
Sept. 23, 2026, 2:40 a.m.
Added
mars_commerce_recover
Sept. 21, 2026, 2:40 a.m.
Added
mars_commerce_reputation
Sept. 21, 2026, 2:40 a.m.
Added
mars_commerce_quote
Sept. 21, 2026, 2:40 a.m.
Added
mars_purchase_feedback
Sept. 21, 2026, 2:40 a.m.
Added
mars_micro_commercial_intelligence_offer
Sept. 21, 2026, 2:40 a.m.
Added
mars_deal_route_precheck
Sept. 21, 2026, 2:40 a.m.
Added
mars_x402_commercial_intelligence_offer
Sept. 21, 2026, 2:40 a.m.
Added
mars_free_commercial_intelligence_preview
Sept. 21, 2026, 2:40 a.m.
Added
prepare_onboarding_proposal
Sept. 21, 2026, 2:40 a.m.
Added
submit_partner_application
Sept. 21, 2026, 2:40 a.m.
Added
discover_commercial_counterparties
Sept. 21, 2026, 2:40 a.m.
Added
record_commission_event
Sept. 21, 2026, 2:40 a.m.
Added
record_attribution
Sept. 21, 2026, 2:40 a.m.
Added
submit_commission_mandate
Sept. 21, 2026, 2:40 a.m.
Added
request_quote
Sept. 21, 2026, 2:40 a.m.
Added
find_counterparty
Sept. 21, 2026, 2:40 a.m.
Added
publish_offer
Sept. 21, 2026, 2:40 a.m.
Added
publish_demand
Sept. 21, 2026, 2:40 a.m.