sk_…). Every operation calls the Logo.dev API (api.logo.dev/v2) with it as a Bearer token. The publishable key (pk_…) only works on the image CDN, which this plugin does not call; the API answers 401 to it.
Lookups spend API credits: search 1 per 1,000 searches, logo 2, brandmark 3, brand profile 5. Account reads, subscriptions and webhook endpoints are free. Out of credits returns 402. A brand Logo.dev has not indexed yet comes back as 202 with data.status not_indexed and metadata.pending.retry_after_seconds; retry after that delay (retries are not billed).
Subscriptions and webhook endpoints need a paid plan with webhooks turned on; the free plan answers 403.
What you get:
- 14 typed API operations
- 2 synced entities (
brands,images) for fast.search()/.list()
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- API Key (Recommended)
Store the Logo.dev API key before the first call: More: API Key
pnpm corsair setup --plugin=logodev --tenant=acme api_key=<your-key> (leave out --tenant without multiTenancy), or pass it as key in the plugin options. With Hub, each tenant enters their own key on the connect page. See API key auth.4
Connect a tenant
Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.
Example API calls
Look up a brand profile by domainsubscriptions.subscribe
Query synced data
Synced entities supporttenant.logodev.db.<entity>.search() and .list(): brands, images.
See Database for filters and operators.
What’s next
API reference
Every
logodev.api.* operation with input and output types.Database
Synced entities, search filters, and operators.
Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.