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_buyer_demand
Discover live open Buyer demand from official procurement sources. No automatic contact and no money movement.
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer'}, 'query': {'type': 'string'}}, 'additionalProperties': True}
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}
intake_formal_eligibility_response
Correlate a supplier response with a prepared request and map evidence into fail-closed formal review. Receipt does not verify sender identity, authenticity or eligibility.
Input schema
{'type': 'object', 'properties': {'match': {'type': 'object'}, 'request': {'type': 'object'}, 'evidence': {'type': 'array'}, 'response': {'type': 'object'}}, 'additionalProperties': True}
intake_supplier_formal_eligibility
Map supplier-provided formal document evidence to procurement requirements. Public intake never self-approves authenticity or eligibility and never sends contact.
Input schema
{'type': 'object', 'properties': {'match': {'type': 'object'}, 'evidence': {'type': 'array'}}, '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}
match_verified_suppliers
Match qualified live Buyer demand to suppliers using exact CPV or strong visible semantic official-award evidence, report eligibility gaps, and preserve a signed-mandate gate. Never contacts parties or moves money.
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer'}, 'query': {'type': 'string'}, 'buyer_limit': {'type': 'integer'}}, 'additionalProperties': True}
prepare_commission_mandate_draft
Prepare a fail-closed commission mandate draft view. Public calls cannot bypass authorized eligibility review and cannot sign, send or activate a mandate.
Input schema
{'type': 'object', 'properties': {'match': {'type': 'object'}, 'evidence': {'type': 'array'}, 'commission_terms': {'type': 'object'}}, 'additionalProperties': True}
prepare_formal_eligibility_outreach
Prepare the exact supplier-facing eligibility evidence request, correlation id, deadline and response schema. It never sends contact automatically.
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer'}, 'query': {'type': 'string'}, 'buyer_limit': {'type': 'integer'}, 'supplier_limit': {'type': 'integer'}}, 'additionalProperties': True}
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}
prepare_supplier_eligibility_request
Prepare but do not send a supplier eligibility evidence request for capability-verified suppliers with public contact routes. Does not mark eligibility or commission agreement verified.
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer'}, 'query': {'type': 'string'}, 'buyer_limit': {'type': 'integer'}}, '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}
qualify_buyer_demand
Commercially qualify live Buyer demand: official structured terms, deadline, supplier requirements, direct entry route, and MARS intermediary commission-route policy. Never contacts buyers or moves money.
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer'}, 'query': {'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}
verify_supplier_public_evidence
Read public supplier websites for contact and supporting capability evidence, then prepare a narrower formal eligibility request without sending it or treating self-published material as formal procurement eligibility proof.
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer'}, 'query': {'type': 'string'}, 'buyer_limit': {'type': 'integer'}, 'supplier_limit': {'type': 'integer'}}, 'additionalProperties': True}
Added
prepare_commission_mandate_draft
Oct. 5, 2026, 2:43 a.m.
Added
intake_formal_eligibility_response
Oct. 5, 2026, 2:43 a.m.
Added
prepare_formal_eligibility_outreach
Oct. 5, 2026, 2:43 a.m.
Added
intake_supplier_formal_eligibility
Oct. 5, 2026, 2:43 a.m.
Added
verify_supplier_public_evidence
Oct. 5, 2026, 2:43 a.m.
Added
prepare_supplier_eligibility_request
Oct. 5, 2026, 2:43 a.m.
Added
match_verified_suppliers
Oct. 5, 2026, 2:43 a.m.
Added
qualify_buyer_demand
Oct. 5, 2026, 2:43 a.m.
Added
discover_buyer_demand
Oct. 5, 2026, 2:43 a.m.
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.