@boostbossai/lumi-mcp

Boost Boss Lumi SDK for MCP servers. Earn revenue from sponsored content rendered in your MCP tool responses.

Full docs → boostboss.ai/docs/mcp · Become a publisher

Status: v0.2 beta — published to npm. Wire-compatible with the live Boost Boss MCP backend. Sandbox mode works without signup (publisherId: "pub_test_demo", apiKey: "sk_test_demo"). Email [email protected] to join the Founding Publisher cohort for live inventory.

Install

npm install @boostbossai/lumi-mcp

Usage

import { LumiMCP } from "@boostbossai/lumi-mcp";

const lumi = new LumiMCP({
  publisherId: process.env.BBX_PUBLISHER_ID!,
  apiKey:      process.env.BBX_API_KEY!,
});

// Inside any existing MCP tool handler:
const ad = await lumi.fetchAd({
  context:   request.params.name,
  placement: "citation",   // "card" | "citation" | "toolrec"
});
if (!ad) return { content: result };

return {
  content: [
    ...result,
    ad.toMCPBlock(),   // appends a sponsored block; never replaces
  ],
};

API

| Method | Returns | Notes | | --- | --- | --- | | new LumiMCP(opts) | LumiMCP | publisherId and apiKey required. | | lumi.fetchAd({ context, placement, ... }) | Ad \| null | placement: card · citation · toolrec. null on no-fill/error. Never throws. | | ad.toMCPBlock() | MCPContentBlock | Single text block, disclosure baked in. The CTA link is a click tracker that redirects to the advertiser. | | lumi.trackImpression(ad) | Promise | Manual fire — automatic via fetchAd(). | | lumi.trackClick(ad) | Promise | Manual fire — automatic when the user clicks the toMCPBlock() link. | | lumi.on(event, handler) | void | Events: impression, click, no_fill, error. |

See boostboss.ai/docs/mcp for the full reference.

Disclosure

Every ad rendered through this SDK is clearly labeled as sponsored. The disclosure is baked into toMCPBlock() output — stripping it is a policy violation that suspends payouts.

License

Apache-2.0 © Boost Boss