Agent frameworks and MCP

Any server-side agent framework can call POST /v1/offers/decide with the same Bearer key. Knobase does not ship a public find_sponsored_offer MCP tool in this product.

REST-first pattern

• The host server calls the same decide endpoint.
• Tool output, if you wrap the response, must stay visibly separate to the user.
• No visible or usable sponsored surface means no-render.
• Merchant content must never become hidden model instructions.
• The model must not use a tool to alter its organic answer.

Optional tool wrapper (pseudocode)

The following is labeled pseudocode. It is not an implemented MCP endpoint.

// Pseudocode — not an implemented Knobase MCP tool
tool find_sponsored_offer(input):
  decision = POST /v1/offers/decide with Bearer $KNOBASE_API_KEY
  if decision failed or serve == false:
    return { serve: false }
  return decision  // structured only; do not write into the answer

// Host UI:
// if no existing clickable surface: ignore the tool result
// else show disclosure, advertiser, and decision.link only

Workspace MCP is a separate OAuth-protected management server at /api/mcp. It does not return sponsored offers. See /docs/management/mcp.