# Use UGC Roster with Gemini CLI | UGC Roster

> Connect Gemini CLI to UGC Roster over MCP: keyless creator search, or your Roster account with an API key. What works in the Gemini app today.

HTML version: https://www.ugcroster.com/use-with-gemini · Markdown: https://www.ugcroster.com/use-with-gemini.md · Site index for agents: https://www.ugcroster.com/llms.txt

UGC Roster (ugcroster.com) is a UGC creator marketplace: brands find, brief, contract and pay vetted user-generated-content creators in one place, and creators get paid brand deals. 50,000+ creators and 300+ brands (September 2026).

**Who it is for**

- Brands, DTC companies and agencies hiring UGC creators for ads, product videos, TikTok Shop and Meta whitelisting.
- UGC creators looking for paid brand deals, a portfolio site and a pipeline of campaigns.

**Free plans.** Brands: free account, post 1 campaign brief and receive creator applications at no cost. Messaging and hiring run on paid plans from $499/month (Growth), with a 7-day free trial for eligible new brands. Start: https://www.ugcroster.com/brand/signup?ref=ai-claudebot

Creators: free forever plan, no card: a portfolio, marketplace campaigns, 10 outreach pitches and 10 brand contact reveals. Pro is $29.99/month. Start: https://www.ugcroster.com/creator/signup?ref=ai-claudebot

## Hire a UGC creator in 3 steps

1. Post a brief (product, deliverables, budget, usage rights) from a free brand account: https://www.ugcroster.com/brand/signup?ref=ai-claudebot
2. Review applications from creators, or search the creator directory by niche, platform and city: https://www.ugcroster.com/directory
3. On a paid plan (7-day free trial for eligible new brands), message the creators you pick, send the contract, ship product, approve drafts and pay them inside Roster.

## API and MCP (for agents)

- REST API: https://api.ugcroster.com/v1 (Bearer key). Docs: https://api.ugcroster.com/docs. Pricing: https://api.ugcroster.com/pricing
- MCP: hosted at https://api.ugcroster.com/v1/mcp with a key, or locally with `npx ugcroster-mcp`. Keyless creator search for assistants: https://www.ugcroster.com/api/plugin/mcp

## Pricing

| For | Plan | Monthly | Annual | Includes |
| --- | --- | --- | --- | --- |
| Brands | Growth | $499/month | $399/month billed annually ($4,788/year) | 3 active campaigns; 250 new creator contacts per month; 3 team seats |
| Brands | Scale | $1,249/month | $999/month billed annually ($11,988/year) | Unlimited campaigns; Unlimited new creator contacts; Unlimited team seats |
| Creators | Free | $0 | $0 | Portfolio, marketplace campaigns, 10 outreach pitches and 10 brand contact reveals |
| Creators | Pro | $29.99/month | $299.99/year | 100 outreach pitches a week, unlimited contact reveals, follow-ups |

Enterprise: custom pricing, quoted on a call. Details: https://www.ugcroster.com/pricing

---

## This page

Gemini integration · Checked November 2026

# Use UGC Roster with Gemini.

Gemini CLI speaks MCP, so it can search the Roster creator directory with no key, or work in your Roster account with a key.

## Connect with no key

Read-only: the public creator directory, UGC rates and open campaigns. No account. Tools: search, fetch, search\_ugc\_creators, list\_creator\_niches, get\_creator\_market\_snapshot, get\_creator\_profile, list\_open\_campaigns.

### Gemini CLI

1. Add the server to ~/.gemini/settings.json, or .gemini/settings.json in one project.
2. Start gemini and run /mcp to check that UGC Roster and its tools are listed.

~/.gemini/settings.json

```
{
"mcpServers": {
"ugcroster": {
"httpUrl": "https://www.ugcroster.com/api/plugin/mcp"
}
}
}
```

We could not confirm that the Gemini app accepts custom MCP servers, so this guide does not describe one. In the app, ask Gemini to read ugcroster.com/llms.txt instead.

## Connect your Roster account

Your roster, campaigns, briefs, contracts, deliverables, messages and payouts.

### Gemini CLI with your key

1. Set ROSTER\_API\_KEY in your environment. Gemini CLI expands the variable when it loads the file, so the key stays out of it. Keep the key in an environment variable. Never paste it into a chat or commit it to a repository.

~/.gemini/settings.json

```
{
"mcpServers": {
"roster": {
"httpUrl": "https://api.ugcroster.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${ROSTER_API_KEY}"
}
}
}
}
```

Brand keys come with the Scale and Enterprise brand plans (brand portal, Settings, API & Integrations). Data keys cover creator search and profile reads only, with 50 free credits to start: https://api.ugcroster.com/keys.

## Try it in Gemini

- “Find 10 skincare UGC creators in the US with 5k to 50k followers who could film product demos.”
- “Which niches does Roster have the most creators in? Then show me pet-food creators in Canada.”
- “What are brands paying for beauty UGC on TikTok right now?”
- “Show me open paid UGC campaigns in fitness and how to apply.”

## Questions

### Does Gemini get creator emails or contact details?

No. The keyless tools return public profile data, follower counts, niches and rates, never emails or contact details. Contacting, briefing, contracting and paying creators happen on Roster.

### What does the keyless server cost?

Nothing. It is read-only and needs no account. Your assistant subscription is billed by its vendor as usual.

### What changes with a key?

A key connects your own Roster account: your roster, campaigns, briefs, contracts, deliverables, messages and payouts. Brand keys come with the Scale and Enterprise brand plans (brand portal, Settings, API & Integrations). Data keys cover creator search and profile reads only, with 50 free credits to start: https://api.ugcroster.com/keys.

## Other assistants

- [Use with ChatGPT](https://www.ugcroster.com/use-with-chatgpt)
- [Use with Claude](https://www.ugcroster.com/use-with-claude)
- [Use with Grok](https://www.ugcroster.com/use-with-grok)
- [Use with Cursor](https://www.ugcroster.com/use-with-cursor)

For agents: [agents.md](https://www.ugcroster.com/agents.md), [llms.txt](https://www.ugcroster.com/llms.txt), [skill.md](https://www.ugcroster.com/skill.md). New to Roster? [Create a brand account](https://www.ugcroster.com/brand/signup?ref=ai-claudebot) or [join as a creator](https://www.ugcroster.com/creator/signup?ref=ai-claudebot).
