# Gemini

> Gemini social media automation. Four ways in.

Canonical page: https://www.socialfaktory.com/agents/gemini

Gemini social media automation, end to end: connect Google Gemini to SocialFaktory from the Gemini app, Gemini Enterprise, the CLI extension or the API, then ask it to price a job, generate video and text, and schedule posts on every channel you have connected.

- **21** Tools
- **3** Scopes

## Pick the Gemini you use

In the Gemini app, add the endpoint below as a custom app: it registers itself and signs you in, so there is no token to mint. In Gemini Enterprise, an administrator adds it as a custom MCP server over Streamable HTTP with the scopes read, generate and publish. On the command line, install the extension and the CLI runs the sign-in, consent screen included. For a managed agent on the Gemini API, name the endpoint as a server tool with a token you minted in the Authorization header.

Endpoint: `POST https://www.socialfaktory.com/mcp`

### Gemini CLI extension

```bash
gemini extensions install https://github.com/socialfaktory/socialfaktory-gemini-extension
```


### Gemini API server tool

```json
{
  "type": "mcp_server",
  "name": "socialfaktory",
  "url": "https://www.socialfaktory.com/mcp",
  "headers": { "Authorization": "Bearer sfp_…" }
}
```


## What the agent can do

- `list_brands` (Read)
- `list_channels` (Read)
- `get_channel_requirements` (Read)
- `list_formats` (Read)
- `get_generation` (Read)
- `list_generations` (Read)
- `get_text_generation` (Read)
- `quote_generation` (Read)
- `create_generation` (Generate)
- `generate_text` (Generate)
- `create_upload` (Generate)
- `complete_upload` (Generate)
- `get_upload` (Read)
- `list_media` (Read)
- `create_posts` (Publish)
- `send_post` (Publish)
- `list_posts` (Read)
- `delete_post` (Publish)
- `check_reference` (Read)
- `get_wallet` (Read)
- `list_actors` (Read)


## How permissions work

- Every token can read. Add generate for anything that spends credits, and publish for creating, scheduling, sending and deleting posts.
- Pin a token to one brand and it sees only that brand, with its channels, generations, posts and text. The credit wallet, uploads, actors and products stay shared across the account.
- Set a monthly credit cap and the token starts no paid call once the month's spend reaches it.
- Every call that spends or publishes carries an idempotency key. A replay inside 24 hours returns the first result instead of doing the work twice.
- 120 calls a minute per token, and 300 requests every 5 minutes per address.

## What it won't do

- Clone a video from a link. That one runs in the app only.
- Generate still images or carousels. Neither is available through an agent yet.
- Connect a social channel. Connecting one is a browser sign-in, so it stays in the app.
- Start a paid call that would pass the cap you set on the token, or change your plan.

## A typical run

1. **Mint the token**: Pick its scopes, pin it to a brand, set a monthly cap. The secret is shown once.
2. **Ask for a price**: quote_generation prices a video for free. It's an optional check, and a render runs without one.
3. **Generate**: create_generation makes the video and charges its price. generate_text reserves a few credits and settles what the write used. Both hand back an id you read the result from.
4. **Schedule it**: create_posts composes one post per channel, and send_post puts it on its channel now or at its time.

## Questions

### How do I connect Gemini to SocialFaktory?

Four ways. Add the endpoint as a custom app in the Gemini app, have an administrator add it as a custom MCP server in Gemini Enterprise, install the CLI extension with one command, or name it as a server tool for a managed agent on the API.

### Does the Gemini app need a token?

No. The app registers itself and sends you to SocialFaktory to sign in, where a consent screen asks what Gemini may do, which brand to pin it to and a monthly credit cap. Google limits custom apps today to personal accounts, 18 or over, in the United States, in English, connected first on the web, with activity saving on.

### What does Gemini Enterprise need from an administrator?

The authorization and token addresses from the discovery document, a client id and secret from a registration at /oauth/register with token_endpoint_auth_method client_secret_post and the administrator's callback address, PKCE switched on, and the scopes read, generate and publish. Streamable HTTP only, which is what this endpoint speaks.

### What does the Gemini CLI extension do?

One command installs it, and the CLI then runs the sign-in itself, consent screen included. Every session after that can read your brands, price a job, generate video and text, and compose, schedule and send posts on X, Instagram, TikTok, YouTube, LinkedIn, Facebook and Pinterest.

### What does it cost?

Reading costs nothing. Generating a video and writing text spend credits from your wallet, and quote_generation prices a video for free before anything runs.

### How do I keep the spending safe?

Grant only the scopes it needs, pin it to one brand, and set a monthly credit cap, on the consent screen or on the token. A post is a draft by default until send_post, and every call that spends or publishes carries an idempotency key, so a retry within 24 hours never pays twice.

## More for developers

- For AI agents: https://www.socialfaktory.com/agents.md
- MCP server: https://www.socialfaktory.com/agents/mcp-server.md
- Claude: https://www.socialfaktory.com/agents/claude.md
- ChatGPT: https://www.socialfaktory.com/agents/chatgpt.md
- Codex: https://www.socialfaktory.com/agents/codex.md
- OpenClaw: https://www.socialfaktory.com/agents/openclaw.md
- Meta Muse: https://www.socialfaktory.com/agents/muse.md
- Read the MCP reference: https://www.socialfaktory.com/docs/mcp.md
- AI assistant: https://www.socialfaktory.com/features/ai-assistant.md