Skip to main content
Xpoz
Back to Use CasesIntegration

Use Xpoz from the Gemini CLI

Add Xpoz to Google's Gemini CLI and give it natural-language access to Twitter/X, Instagram, TikTok, and Reddit for brand monitoring, lead gen, and social listening.

Get Started FreeView Pricing

What is Gemini CLI?

Gemini CLI is Google's open-source command-line coding agent. It reads MCP servers from ~/.gemini/settings.json. Adding Xpoz there lets Gemini query social data through the same tool-call interface it uses for filesystem, git, and shell operations.

Configuration

Add an entry under mcpServers. Replace YOUR_XPOZ_API_TOKEN with your token from the Xpoz dashboard.

File: ~/.gemini/settings.json

{
  "mcpServers": {
    "xpoz": {
      "httpUrl": "https://mcp.xpoz.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_XPOZ_API_TOKEN"
      },
      "timeout": 30000
    }
  }
}

For the latest syntax, see the official Gemini CLI MCP documentation.

Test query

Run this to confirm the connection works:

> @xpoz search Twitter for posts mentioning "Gemini CLI" in the last 24 hours and summarize the top themes.

Example prompts

Brand monitoring

Cross-platform brand sweep from Gemini CLI

> @xpoz scan Twitter/X, Reddit, and Instagram for mentions of "YourBrand" in the last 7 days. Return a markdown table with platform, mention count, and the three most-engaged posts per platform.

Lead generation

Buying-signal prospecting on Reddit and Twitter

> @xpoz find recent Twitter/X and Reddit posts where users are asking for alternatives to CompetitorName or evaluating tools in YourCategory. For each, return the platform, author, link, and a one-line lead note.

Troubleshooting

Gemini CLI does not show @xpoz as an available tool prefix

Make sure the entry is inside the "mcpServers" object in ~/.gemini/settings.json and that the JSON parses (trailing commas and comments are not allowed). Restart Gemini CLI after saving.

Requests time out

Increase the `timeout` field (milliseconds). Bulk queries against 1.5B+ posts can take >10s on the free tier.

401 Unauthorized

Regenerate your token at https://www.xpoz.ai/get-token and update the Authorization header value.

Why XPOZ + Gemini CLI?

No Platform API Keys Needed

Access Twitter, Instagram, TikTok, and Reddit data without obtaining API keys from each platform.

Natural Language Queries

Ask questions in plain English instead of writing complex API calls.

Unified Multi-Platform Access

One tool to query all major social platforms simultaneously.

Generous Usage Limits

Free tier includes 100K results/month. Pro plans scale to 10M+.

Getting Started

1

Sign up for XPOZ

Create a free account at xpoz.ai to get your MCP server credentials.

2

Configure Gemini CLI

Add the XPOZ MCP server to your Gemini CLI configuration.

3

Start Querying

Your Gemini CLI agents can now access social media data through natural language queries.

Ready to Connect XPOZ with Gemini CLI?

Get started with 100,000 free results per month. No credit card required.

Get Started FreeView Pricing