@byimprint/mcp-server

@byimprint/mcp-server

Open-source MCP client for byImprint creator-audience intelligence.

The actual MCP server, scoring methodology, and creator data live behind authentication at https://byimprint.com/mcp. This package is the open-source plumbing: the tool descriptors, a thin TypeScript client, and a small CLI for setup. Modeled on Plaid Link.

Install (Claude Code)

claude mcp add imprint-intelligence https://byimprint.com/mcp

That is the entire setup. Free tier requires no API key, no credit card. Get a paid-tier key at byimprint.com/agents.

Install (ChatGPT, Cursor, custom OpenAI agents)

Add https://byimprint.com/mcp as a Custom Connector in ChatGPT, or point your agent runtime at the OpenAPI spec:

https://byimprint.com/.well-known/openapi.json

Discovery descriptor for MCP clients that prefer auto-config:

https://byimprint.com/.well-known/mcp.json

Tools

Seven composable tools for iterating across creators and niches inside an agent loop.

Tool	Purpose	Tier
imprint-search	Keyword search across creators and niches.	Free
imprint-niche	Niche landscape: creators, score distribution, common risks. Free returns 42 public niches; paid returns all 180.	Free / Paid
imprint-profile	Per-creator deep-dive. Free returns the card view; paid returns full sections.	Free / Paid
imprint-filter	Structured filter across creators by score, niche, partnerships, etc.	Indie
imprint-grep	Regex match across creator analyses.	Indie
imprint-map	Question-across-set with optional Claude synthesis. Synthesis is Agency or pay-per-call.	Indie
imprint-rank-creators-for-brand	Rank creators against a brand brief with evidence and exclusions.	Agency (5/mo) or pay-per-call

Pricing

Tier	Monthly	Calls	Notes
Free	$0	100 / day	Public niches and creator search. No card.
Indie	$49	5,000 / mo	All read tools.
Agency	$499	50,000 / mo	+ 5 brand-creator ranks included, $99/call after.
Pay-per-call	usage	usage	$99/rank, $5/map-synthesize.

Programmatic use

import { imprintFetch, IMPRINT_TOOLS } from "@byimprint/mcp-server";

const tools = await imprintFetch("tools/list", {});
console.log(tools);

const search = await imprintFetch(
  "tools/call",
  { name: "imprint-search", arguments: { query: "quilting fabric" } },
  { apiKey: process.env.IMPRINT_API_KEY },
);
console.log(search);

For agent runtimes, prefer a real MCP client (@modelcontextprotocol/sdk) and point it at https://byimprint.com/mcp with your bearer token in Authorization.

CLI

npx @byimprint/mcp-server install
npx @byimprint/mcp-server tools
npx @byimprint/mcp-server discover
IMPRINT_API_KEY=imp_... npx @byimprint/mcp-server ping

Methodology

Every score traces back to YouTube Data API metrics, comment evidence, and the published six-axis framework: Voice, Audience, Product, Partnership, Risk, Reach. Read the full methodology at byimprint.com/methodology.

License

MIT. See LICENSE.