> For the complete documentation index, see [llms.txt](https://socialcli.gitbook.io/socialcli-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://socialcli.gitbook.io/socialcli-docs/getting-started.md).

# Getting Started

## Getting Started <a href="#getting-started" id="getting-started"></a>

#### 1. Connect Your Wallet <a href="#id-1-connect-your-wallet" id="id-1-connect-your-wallet"></a>

Go to [socialcli.xyz](https://socialcli.xyz/) and click **Connect Wallet**. Sign in with any Solana wallet (Phantom, Solflare, Backpack) or EVM wallet (MetaMask, WalletConnect, Coinbase Wallet).

No email or password - your wallet is your identity.

#### 2. Explore Without Setup <a href="#id-2-explore-without-setup" id="id-2-explore-without-setup"></a>

Once connected, you have immediate access to:

* **Dashboard** - overview of your posts, scheduled content, connected accounts, and recent activity
* **Compose** - create and publish posts to any connected platform
* **Queue** - view and manage your content buffer
* **API Keys** - generate keys for CLI and API access

#### 3. Choose a Plan <a href="#id-3-choose-a-plan" id="id-3-choose-a-plan"></a>

Social CLI uses a credit-based system. To start posting:

1. Go to **Plans** (`/plans/subscription`)
2. Choose a plan - Standard (9/mo),Team(9/mo),Team(29/mo), Pro (59/mo),orUltimate(59/mo),orUltimate(99/mo)
3. Pay with USDC on Solana, Base, or Ethereum via the X402 protocol or Standard
4. Credits are added instantly

#### 4. Connect Social Accounts <a href="#id-4-connect-social-accounts" id="id-4-connect-social-accounts"></a>

After subscribing, connect your platforms:

**Via Dashboard:**

1. Go to **Accounts** (`/dashboard/accounts`)
2. Click the platform you want to connect
3. Complete the OAuth flow - takes seconds
4. Account appears in your connected list

**Via CLI:**

```
social-cli accounts list
```

No developer accounts required. Social CLI handles all OAuth, token refresh, and API access on your behalf.

> Bluesky connects via handle and app password - no OAuth needed.

#### 5. Create Your First Post <a href="#id-5-create-your-first-post" id="id-5-create-your-first-post"></a>

**Via Dashboard:**

1. Go to **Compose** (`/dashboard/compose`)
2. Write your post, attach media if needed
3. Select target platforms
4. Click Publish or Schedule

**Via CLI:**

```
social-cli posts create -c "Hello from Social CLI!" -p twitter -a <accountId> --now
```

**Via MCP (Claude/Cursor):**

> "Post 'Just shipped a new feature' to Twitter and LinkedIn"

#### 6. Set Up the CLI <a href="#id-6-set-up-the-cli" id="id-6-set-up-the-cli"></a>

```bash
npm install -g social-cli
social-cli auth:set --key sk_live_your_key_here
social-cli auth:check
social-cli accounts list
```

Generate your API key at **Dashboard > API Keys** (`/dashboard/api-keys`).

#### 7. Set Up MCP <a href="#id-7-set-up-mcp" id="id-7-set-up-mcp"></a>

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "social-cli": {
      "url": "https://backend.socialcli.xyz/mcp/social-cli",
      "headers": {
        "x-api-key": "sk_live_..."
      }
    }
  }
}
```

Works with Claude Desktop, Cursor, and any MCP-compatible client.

***

## Supported Platforms <a href="#supported-platforms" id="supported-platforms"></a>

Social CLI supports 14 social platforms. All use OAuth except Bluesky, which connects via handle and app password.

| Platform        | Post | Schedule | Queue | Inbox | Analytics |
| --------------- | :--: | :------: | :---: | :---: | :-------: |
| Twitter/X       | Live |   Live   |  Live |  Soon |    Soon   |
| Instagram       | Live |   Live   |  Live |  Soon |    Soon   |
| Facebook        | Live |   Live   |  Live |  Soon |    Soon   |
| LinkedIn        | Live |   Live   |  Live |   No  |    Soon   |
| TikTok          | Live |   Live   |  Live |   No  |    Soon   |
| YouTube         | Live |   Live   |  Live |   No  |    Soon   |
| Bluesky         | Live |   Live   |  Live |   No  |    Soon   |
| Telegram        | Live |   Live   |  Live |  Soon |     No    |
| Threads         | Live |   Live   |  Live |   No  |     -     |
| Pinterest       | Live |   Live   |  Live |   No  |    Soon   |
| Reddit          | Live |   Live   |  Live |  Soon |    Soon   |
| Discord         | Live |   Live   |  Live |   No  |     -     |
| Snapchat        | Live |   Live   |  Live |   No  |     -     |
| Google Business | Live |   Live   |  Live |   No  |    Soon   |

<br>

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://socialcli.gitbook.io/socialcli-docs/getting-started.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.