Authentication

The CLI requires an access key to authenticate with the Xpoz MCP server. Get your key from the Xpoz dashboard.

Start instantly — no account needed. Generate a free token and use it as your API key:

TOKEN=$(curl -s -X POST https://api.xpoz.ai/api/trial/token -H "Content-Type: application/json" -d '{"source":"docs"}' | jq -r .data.accessKey)
export XPOZ_API_KEY=$TOKEN
xpoz-cli twitter get_user --identifier elonmusk

This returns a preview of up to 5 results per call. To get full data, pagination, and CSV export, create a free account — no credit card required.

Get your access key

Store the key

xpoz-cli auth login

You will be prompted to enter your access key. The key is stored locally in a config file (see Config File Location below).

Verify

xpoz-cli auth status

Confirms that a valid access key is stored and shows your account status.

Logout

Remove the stored access key:

xpoz-cli auth logout

Auth Commands

Command	Description
`xpoz-cli auth login`	Store your access key
`xpoz-cli auth status`	Check authentication status
`xpoz-cli auth logout`	Remove stored credentials

Credential Precedence

The CLI resolves credentials in this order:

--api-key flag — highest priority, overrides everything
XPOZ_API_KEY environment variable — useful for CI/CD and scripting
Stored config file — set by xpoz-cli auth login

# Use a specific key for one command
xpoz-cli twitter get_user --identifier elonmusk --api-key sk-your-key

# Or set the environment variable
export XPOZ_API_KEY=sk-your-key
xpoz-cli twitter get_user --identifier elonmusk

For CI/CD pipelines and automation, use the XPOZ_API_KEY environment variable. For local development, auth login is more convenient.

Config File Location

Linux / macOS
Windows

~/.config/xpoz/config.json

The file is created with 0600 permissions (owner read/write only) to protect your access key.

%APPDATA%\xpoz\config.json

The config file contains your access key in plain text. Do not commit it to version control. The CLI sets restrictive file permissions (0600) on Linux and macOS to prevent other users on the system from reading it.

CLI

Authentication

Logout

Auth Commands

Credential Precedence

Config File Location

Next Steps

Usage

MCP Authentication

​Login

​Logout

​Auth Commands

​Credential Precedence

​Config File Location

​Next Steps

Usage

MCP Authentication

Login

Logout

Auth Commands

Credential Precedence

Config File Location

Next Steps