MCP Server

BestBid Agent Sponsorship

lol.bestbid/sponsorship
Marketing & Advertising Payments & Fintech Public & reachable MCP 2025-11-25

What this MCP does

Finds paid advertising rankings, provides sponsorship quotes, and enables wallet-based purchases and listing updates.

get_ranking
Read current paid positions and prices for one active ranking. Data comes from the live database.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'pattern': '^[a-z0-9-]{1,120}$'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}}, 'additionalProperties': False}
get_sponsorship_info
Read BestBid advertising rules, terms version, live payment availability and supported agent wallets before buying.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
get_sponsorship_status
Privately check payment and publication independently. Poll until confirmed. Contains no payer identity or payment provider identifiers.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['orderId', 'statusToken'], 'properties': {'orderId': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$'}, 'statusToken': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]{43}$'}}, 'additionalProperties': False}
purchase_sponsorship
Buy the quoted sponsored placement using your authorized wallet via MPP or x402. Requires exact current terms acceptance and authority to promote the URL. Payment metadata is provided by your wallet integration. Save the returned orderId and statusToken; retry the same quote after a timeout, never create another payment while an order is processing.
Open world Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['quoteId', 'quoteToken', 'protocol', 'acceptedTermsVersion', 'authorizedToPromote'], 'properties': {'quoteId': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$'}, 'protocol': {'enum': ['mpp', 'x402'], 'type': 'string'}, 'quoteToken': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]{43}$'}, 'authorizedToPromote': {'type': 'boolean', 'const': True}, 'acceptedTermsVersion': {'type': 'string', 'const': '2026-09-06'}}, 'additionalProperties': False}
quote_sponsorship
Get a five-minute exact sponsorship quote within maxPaymentCents. This does not charge or reserve a ranking position. Keep quoteToken private.
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['rankingSlug', 'productUrl', 'strategy', 'maxPaymentCents'], 'properties': {'strategy': {'enum': ['custom_total', 'take_first'], 'type': 'string'}, 'productUrl': {'type': 'string', 'maxLength': 2048, 'minLength': 1}, 'rankingSlug': {'type': 'string', 'pattern': '^[a-z0-9-]{1,120}$'}, 'maxPaymentCents': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'targetTotalCents': {'type': 'integer', 'maximum': 9007199254740991, 'multipleOf': 100, 'exclusiveMinimum': 0}}, 'additionalProperties': False}
search_rankings
Find active paid advertising rankings for your agent, product, brand or service. Reading is free. Rank is paid placement, not endorsement.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1}, 'query': {'type': 'string', 'default': '', 'maxLength': 120}, 'category': {'type': 'string', 'maxLength': 80}}, 'additionalProperties': False}
update_sponsorship_copy
Update tagline and description only when the private order capability controls the listing. Paying to boost someone else's listing does not grant edit access.
Destructive Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['orderId', 'statusToken', 'tagline', 'description'], 'properties': {'orderId': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$'}, 'tagline': {'type': 'string', 'maxLength': 160, 'minLength': 1}, 'description': {'type': 'string', 'maxLength': 600}, 'statusToken': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]{43}$'}}, 'additionalProperties': False}
Added
update_sponsorship_copy
Sept. 17, 2026, 12:54 p.m.
Added
get_sponsorship_status
Sept. 17, 2026, 12:54 p.m.
Added
purchase_sponsorship
Sept. 17, 2026, 12:54 p.m.
Added
quote_sponsorship
Sept. 17, 2026, 12:54 p.m.
Added
get_ranking
Sept. 17, 2026, 12:54 p.m.
Added
search_rankings
Sept. 17, 2026, 12:54 p.m.
Added
get_sponsorship_info
Sept. 17, 2026, 12:54 p.m.