For AI

Use okdata in DeepSeek Harness: the built-in MCP client

Add okdata to a DeepSeek Harness profile through its built-in MCP client, so DeepSeek models can fetch social data from 17 platforms.

Updated 2026-11-12

The address DeepSeek Harness connects to https://api.okdata.online/mcp

One address and one header: your API key as a bearer token.

DeepSeek Harness runs DeepSeek models as agents with your own tools. Its built-in MCP client takes a remote server with fixed headers, which is all okdata needs. Once the profile has it, ask in plain words; the model finds the endpoint, states the price and fetches one page at a time.

Connect it

  1. Open the place MCP servers are added. Edit $DSH_HOME/profiles/<profile>/cordis.patch.yml (or $DSH_HOME/cordis.patch.yml for every profile; $DSH_HOME is ~/.dsh by default) and add an entry for the built-in MCP client.
  2. Paste the configuration. Replace the key placeholder with your own key.
    cordis.patch.yml
    - insert:
        - id: mcp-okdata
          name: '@deepseek-ai/dsh-mcp-client'
          config:
            serverName: okdata
            transport: streamable-http
            url: https://api.okdata.online/mcp
            headers:
              Authorization: 'Bearer okd_…'
            toolCallTimeoutMs: 120000
  3. A new file holds []: replace it rather than appending below it. Check with dsh --profile <profile> --dump-config, then start a new session.
  4. Ask it to list the tools. The reply should match the one below.

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.

None of this costs anything.

A first conversation

“What is on Weibo hot search right now?”

Tool callResultCost
find {"query":"weibo hot search"}weibo.trends.list · $0.002 per call · about 50 board entries per pageFree
call {"capability":"weibo.trends.list"}One page of about 50 entries$0.002

2 tool calls · 1 charged · $0.002

Then try: “Use okdata to show me what is on Weibo's hot search right now.”

Tips for DeepSeek Harness

  • 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 DeepSeek Harness

  • DeepSeek Harness is a developer preview and says its settings may change.
  • Its tool timeout is 60 seconds unless set; the entry above gives two minutes.
  • If the server cannot be reached the harness still starts, but no okdata tools appear.

Sources

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

If something is off

What you seeWhyFix
DeepSeek Harness does not list the okdata toolsIt was started before the server was added, or the address differs from the one above.Check the entry, then restart DeepSeek Harness or start a new chat.
find works, call says unauthorizedThe 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_balanceThe balance does not cover the most this call can cost. Nothing was charged.Ask it to run account, then top up in the console.

Connect once, then just ask.

Every new key comes with $0.10 to try it. One sentence connects your agent.

Start free
Connect your AI

Paste this into your agent

Read https://okdata.online/agents.md and set up okdata for me; my key is in the OKDATA_API_KEY environment variable.

Claude Code, Cursor, Codex and other agents that can open a link set themselves up from it.

MCP serverhttps://api.okdata.online/mcp