# get_connect_link

> Get a link to connect an account with Wavegrain's MCP server: the get_connect_link tool needs the read permission. Inputs, outputs and an example call.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**Get a link to connect an account.** Permission: `read`. Read-only: changes nothing.

A one-click link for the user to connect a social account into a group. They sign in on the network; an agent never handles the account's password or tokens.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `groupId` | string | yes | The account group the new account joins, from list_accounts. up to 200 characters |
| `network` | "tiktok" \| "instagram" \| "threads" \| "facebook" \| "linkedin" \| "pinterest" \| "x" \| "youtube" | no | The network the user wants; the answer says what Wavegrain can post there. |

The fields inside an object or a list are in the JSON Schema at [/developers/mcp-tools.json](/developers/mcp-tools.json).

## Returns

| Field | Type | Notes |
| --- | --- | --- |
| `link` | string | Opens Wavegrain's connect step on this group; the user picks the network and signs in there. |
| `brand` | object | The group's brand. |
| `group` | object | The group the account joins. |
| `network` | object \| null | What Wavegrain can do on the network asked for; null when none was given. |
| `note` | string | What to tell the user. |

## Example call

Send it to `POST https://wavegrain.com/api/mcp` with an access key that has the `read` permission; [Authentication](/developers/authentication) shows how to make one.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_connect_link",
    "arguments": {
      "groupId": "<groupId>"
    }
  }
}
```

The call shows only the required inputs, with placeholder values: put your own in.

## Related tools

- [`plan_week`](/developers/mcp-tools/plan_week): Plan a week of posts
- [`get_brand_usage`](/developers/mcp-tools/get_brand_usage): Get a brand's usage
- [`list_accounts`](/developers/mcp-tools/list_accounts): List accounts and groups
- [`get_post_status`](/developers/mcp-tools/get_post_status): Get a post's status
- [`get_post_events`](/developers/mcp-tools/get_post_events): Get a post's history
- [`search_inspiration`](/developers/mcp-tools/search_inspiration): Search the Inspiration library
- [All 79 tools](/developers/mcp-tools)
