# Use okdata in Cherry Studio: social data for any model you run

> Add okdata to Cherry Studio as a Streamable HTTP MCP server, so whichever model you chat with can read Xiaohongshu, Douyin, Bilibili and X data.

Canonical page: https://okdata.online/integrations/cherry-studio/

Cherry Studio lets you chat with many models side by side. Add okdata once and each of them can look things up on social platforms: "find this week's most-saved Xiaohongshu notes about sunscreen", "what is trending on Bilibili today". You keep choosing the model; okdata supplies the data and states each price.

## Connect it

Address: `https://api.okdata.online/mcp`

1. Settings (设置) → MCP → MCP Servers (MCP 服务器) → Add (添加) → Quick Create (快速创建).
2. Fill in the fields:

| Field | Value |
|---|---|
| 名称 Name | `okdata` |
| 类型 Type | Streamable HTTP (`streamableHttp`) |
| URL | `https://api.okdata.online/mcp` |
| 请求头 Headers (高级设置) | One header per line as Name=Value: `Authorization=Bearer okd_…` |

- Save. A new server starts switched off: switch it on, wait for 已连接 (connected) and check its 工具 (tools) tab.
- Using an Agent? Add the server to that agent too, in the agent's MCP settings.

## Check it works

> List the okdata tools.

okdata is connected with 5 tools: `find` describe the data you need in words; get up to five capabilities with what they need, the price and a ready call. It never offers another platform in place of the one asked for; `describe` read the full contract of one to five capabilities: parameters, links taken, price and the most a call can cost, paging, fields and an example item; `call` fetch one page of data as text: the first lines say what it cost, the balance left and how to get the next page. Failed calls are free; max_price caps a call; `read_more` read the rest of an answer that was cut at about 20 KB, or the same result in another view, for 24 hours; `account` balance and the key’s spending limits, a receipt for one call, usage by day or capability; which capabilities are up, even without a key. Only `call` costs money. The catalog has 214 endpoints on 17 platforms.

## A first conversation

> What is on Weibo hot search right now?

| Tool call | Result | Cost |
|---|---|---|
| `find {"query":"weibo hot search"}` | weibo.trends.list · $0.002 per call · about 50 board entries per page | Free |
| `call {"capability":"weibo.trends.list"}` | One page of about 50 entries | $0.002 |

2 tool calls · 1 charged · $0.002

## Tips for Cherry Studio

- **Let the free tools run without asking.** Allow `find`, `describe` and `account`; keep `call` on “ask” if you want to approve every charge.
- **Ask for the cost first.** “Tell me what this will cost before you call anything” works in every client.
- **Give each client its own key.** Create one per app in the console; revoking it then touches nothing else.
- **Retries are safe.** A resent call with the same `idempotency_key` is never charged twice, and failed calls are free.

## What to know about Cherry Studio

- To change the key later, switch the server off first, edit, then switch it on again.

Then try: “Use okdata to find popular Xiaohongshu notes about sunscreen.”

From Cherry Studio's own documentation, read on 2026-11-12. Menus move; if a step differs, the client's page is right.

- https://github.com/CherryHQ/cherry-studio
- https://docs.cherry-ai.com/

## If something is off

| What you see | Why | Fix |
|---|---|---|
| Cherry Studio does not list the okdata tools | It was started before the server was added, or the address differs from the one above. | Check the entry, then restart Cherry Studio or start a new chat. |
| `find` works, `call` says `unauthorized` | The key did not arrive. `find` and `describe` need none, so they still answer. | Check the header is `Authorization` with `Bearer ` and a key starting with `okd_`, then restart. |
| `call` says `insufficient_balance` | The balance does not cover the most this call can cost. Nothing was charged. | Ask it to run `account`, then top up in the console. |