# Use okdata in WorkBuddy: add it to mcp.json

> Add okdata to WorkBuddy's mcp.json so its agent can list WeChat Official Account articles, read Douyin comments and check hot lists for your reports.

Canonical page: https://okdata.online/integrations/workbuddy/

WorkBuddy is a desktop work agent from the CodeBuddy team. With okdata in its MCP settings it can gather the data for a weekly report by itself: the newest articles of the Official Accounts you watch, the comments under a launch video, today's hot lists. Each paid call states its price.

## Connect it

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

1. 插件 (Plugins) in the sidebar → MCP 服务器 (MCP servers), top right → 配置 MCP (Configure MCP). This opens `~/.workbuddy/mcp.json` (or `.workbuddy/mcp.json` in a project) for editing.

Under mcpServers in mcp.json: 

```json
{
  "mcpServers": {
    "okdata": {
      "type": "http",
      "url": "https://api.okdata.online/mcp",
      "headers": {
        "Authorization": "Bearer okd_…"
      }
    }
  }
}
```

- Save; edits take effect at once. The dot beside the server turns green when it connects.

## 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 WorkBuddy

- **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 WorkBuddy

- WorkBuddy's own guide shows only local servers. The remote form above (`type`, `url`, `headers`) is the one its sister tool CodeBuddy documents; if the dot stays red, tell us and check the WorkBuddy changelog.
- Never commit a project `mcp.json` with your key in it.

Then try: “Use okdata to list the newest articles of this WeChat Official Account.”

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

- https://www.workbuddy.ai/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/MCP-Guide

## If something is off

| What you see | Why | Fix |
|---|---|---|
| WorkBuddy 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 WorkBuddy 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. |