Structured brand identity intelligence for 245K+ brands. Colors, typography, logos, conformity scores — accessible via REST API or directly in Claude via our MCP server.
The Bivernado API is a RESTful service at https://bivernado.com/api/v1. Most endpoints work without authentication on the free tier.
# Search for brands in fintech
curl "https://bivernado.com/api/v1/brands/search?query=fintech&limit=5"
# Look up a specific brand
curl "https://bivernado.com/api/v1/brands/stripe.com"
# Get CSS design tokens
curl "https://bivernado.com/api/v1/brands/spotify.com/tokens?format=css"No API key needed for basic endpoints. The free tier includes 500 requests/month. For higher limits and pro endpoints, get an API key from the pricing page.
Pass your API key as a Bearer token in the Authorization header. Keys use the format biv_sk_live_* (production) or biv_sk_test_* (sandbox).
curl "https://bivernado.com/api/v1/brands/stripe.com/intel" \
-H "Authorization: Bearer biv_sk_live_abc123def456ghij"Every response follows a consistent envelope:
{
"success": true,
"data": { ... },
"meta": {
"total": 1250,
"page": 1,
"limit": 20,
"totalPages": 63
}
}Errors return a structured error object:
{
"success": false,
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded",
"retryAfter": 3600
}
}Rate limits use a 24-hour sliding window. Every response includes headers showing your current usage.
| Tier | Requests / Day | Price | Pro Endpoints |
|---|---|---|---|
| free | 500 / month | $0 | No |
| pro | 5,000 / month | $49/mo | Yes |
| scale | 25,000 / month | $149/mo | Yes |
| enterprise | Unlimited | Custom | Yes |
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4987
X-RateLimit-Reset: 1710374400When the API operates in degraded mode (Redis unavailable), rate limiting is temporarily skipped and an X-Degraded: rate-limiting header is added.
/api/v1/brands/searchFreeFull-text search across 245K+ brands. Filter by industry, market scope, or free-text query.
curl "https://bivernado.com/api/v1/brands/search?query=coffee&industry=Food+%26+Beverage&limit=10"/api/v1/brands/{identifier}FreeLook up a single brand by domain, slug, or UUID. Includes full color palette, typography, logo, and metadata.
curl "https://bivernado.com/api/v1/brands/spotify.com"/api/v1/brands/{identifier}/tokensFreeGenerate ready-to-use design tokens from a brand's visual identity. Outputs CSS custom properties, Tailwind config, or SCSS variables.
css (default), tailwind, or scss:root {
/* Spotify — design tokens by Bivernado */
--brand-primary: #1DB954;
--brand-secondary: #191414;
--brand-accent: #1ed760;
--brand-background: #121212;
--brand-text: #FFFFFF;
--brand-font-heading: 'Circular', sans-serif;
--brand-font-body: 'Circular', sans-serif;
}/api/v1/brands/{identifier}/intelPro+Deep brand intelligence profile with conformity scoring, color harmony analysis, typography assessment, and industry benchmarks.
curl "https://bivernado.com/api/v1/brands/stripe.com/intel" \
-H "Authorization: Bearer biv_sk_live_abc123def456ghij"/api/v1/comparePro+Side-by-side comparison of two brands. Color similarity, typography overlap, industry positioning, and visual distance scoring.
curl "https://bivernado.com/api/v1/compare?domains=stripe.com,paypal.com" \
-H "Authorization: Bearer biv_sk_live_abc123def456ghij"/api/v1/industriesFreeList all 85 industry categories with brand counts.
curl "https://bivernado.com/api/v1/industries"/api/v1/industries/{name}Pro+Industry benchmark with dominant colors, popular fonts, top brands, and visual trends across the sector.
curl "https://bivernado.com/api/v1/industries/Fintech" \
-H "Authorization: Bearer biv_sk_live_abc123def456ghij"/api/v1/healthFreeService health check. Returns status of database and Redis with latency measurements.
{
"status": "ok",
"timestamp": "2026-03-13T12:00:00.000Z",
"services": {
"database": { "status": "ok", "latencyMs": 2 },
"redis": { "status": "ok", "latencyMs": 1 }
}
}The Bivernado MCP server lets Claude (and other MCP-compatible AI agents) access brand data directly. Search brands, generate design tokens, compare identities — all from within your AI assistant.
npm install -g @bivernado/mcpAdd to your claude_desktop_config.json:
{
"mcpServers": {
"bivernado": {
"command": "bivernado-mcp",
"env": {
"BIVERNADO_API_KEY": "biv_sk_live_abc123def456ghij",
"BIVERNADO_BASE_URL": "https://bivernado.com"
}
}
}
}Add to .claude/settings.json in your project:
{
"mcpServers": {
"bivernado": {
"command": "npx",
"args": ["-y", "@bivernado/mcp"],
"env": {
"BIVERNADO_API_KEY": "biv_sk_live_abc123def456ghij"
}
}
}
}brand_lookupLook up a brand by domain, slug, or name
brand_searchSearch brands by query, industry, or filters
design_tokensGenerate CSS/Tailwind/SCSS tokens for a brand
brand_intelligenceFull intelligence profile with scoring (Pro)
brand_compareCompare two brands side-by-side (Pro)
industry_benchmarkIndustry trends and benchmarks (Pro)
The MCP server also exposes resources for context injection:
bivernado://industriesList of all industry names with brand countsbivernado://brands/{domain}Full brand profile for a specific domainbivernado://industries/{name}Industry benchmark data“What design tokens does Stripe use? Give me the CSS variables.”
Claude uses design_tokens with {domain: "stripe.com", format: "css"}
Returns ready-to-paste CSS custom properties with Stripe's primary purple, dark navy, mint accent, and font stack.
The full OpenAPI 3.1 specification is available at /api/v1/openapi. Use it to generate client libraries, import into Postman, or integrate with any tool that supports OpenAPI.
# Save the spec locally
curl "https://bivernado.com/api/v1/openapi" -o bivernado-openapi.json
# Generate a TypeScript client
npx openapi-typescript bivernado-openapi.json -o ./bivernado-api.d.tsStart with the free tier — 500 requests/month, no API key required. Upgrade to Pro for intelligence endpoints, comparisons, and higher limits.