ddbx — insider dealings

io.github.jonwillingtonPublished by GitHub account jonwillingtonv1.0.0Updated Oct 24, 2026

Search rated insider dealings across the UK, US, Sweden, Netherlands and US Congress.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingFinance

Overview

AI-generated overview

A public, read-only remote MCP server for searching ddbx-rated insider share dealings in the UK, US, Sweden, the Netherlands and US Congress.

What you can do
Search recent insider dealings by market, ticker or disclosure date, filtered to rated filings by default or all screened open-market filings on request. Look up a single filing by its id, or the recent dealings, business description and company page link for one UK- or US-listed company. Read ddbx's written daily recap for a UK or US trading day, or the latest one. Find dealings by company name or ticker and fetch the full thin-tier record for a returned id.
When to use it
Useful when you want an assistant to answer questions about director or insider buying and selling, scan a market for notable filings, or check what US Congress members have traded, without leaving the chat.
Requirements
A remote streamable HTTP endpoint; no API key or account is needed. The README describes adding the hosted URL as a custom connector or HTTP MCP server in clients such as Claude, Cursor, VS Code, Claude Code, Gemini CLI or Codex. Network access to the hosted service is required.
Before you install
Read-only and unauthenticated, so no credentials are exposed. It serves only the thin tier: analysis prose is not provided, so ratings should not be explained beyond what the record says. Data covers only the listed markets and is limited to what ddbx has screened and rated.

Installation

In SourceWeft

  1. Open ddbx — insider dealings in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.jonwillington%2Fddbx/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "ddbx-insider-dealings": {
      "type": "http",
      "url": "https://api.ddbx.uk/mcp"
    }
  }
}

README

ddbx plugin (ChatGPT + Codex)

An Agent Plugins 1.0 package that puts ddbx insider dealings into ChatGPT and Codex. It bundles:

  • The ddbx MCP server (https://api.ddbx.uk/mcp): read-only, no auth, thin tier only. The server lives in ddbx-data/worker/mcp.ts; this repo only points at it.
  • Three skills that teach the assistant how to use the tools well:
    • company-insiders: insider activity at one company (UK, US, SE, NL, Congress)
    • market-scan: the notable dealings across a market over a period
    • daily-recap: ddbx's published daily summary for the UK or US
.agents/plugins/marketplace.json   repo marketplace, so Codex can add this repo directlyplugins/ddbx/  plugin.json                      root manifest, with the com.openai interface block  mcp.json                         the remote MCP server  skills/<name>/SKILL.md           workflows  skills/<name>/agents/openai.yaml display name + MCP dependency per skill  assets/icon.png, logo.png        from ddbx-site/public/ios-app-icon-uk.pngSUBMISSION.md                      listing copy and test cases for the submission portal

Connect

The hosted server is public, read-only and needs no API key: https://api.ddbx.uk/mcp.

  • Claude: Customize → Connectors → Add custom connector → paste the URL.
  • Cursor / VS Code: add an HTTP MCP server named ddbx with that URL.
  • Claude Code: claude mcp add --transport http ddbx https://api.ddbx.uk/mcp
  • Gemini CLI: gemini extensions install https://github.com/jonwillington/ddbx-plugin
  • Codex: codex plugin marketplace add jonwillington/ddbx-plugin
  • Smithery: jonathanwillington/ddbx

The repository also carries manifests for the official MCP Registry, Cursor Marketplace, Gemini CLI and OpenAI Agent Plugins.

Contract with ddbx-data

The skills name the MCP tools (search_dealings, get_dealing, get_company, get_daily_summary, search, fetch) and their arguments. Renaming a tool or an argument in worker/mcp.ts breaks this plugin as well as any cached connector: change it additively, then update the skills here.

The skills also restate the thin-tier posture: the analysis prose is not served, so the assistant links to each filing's url and never invents a reason for a rating. If the MCP ever serves analysis behind auth, update the Rules sections.

Test in Codex

bash
codex plugin marketplace add ./          # from this repo rootcodex plugin marketplace list

Then enable it in ~/.codex/config.toml:

toml
[plugins."ddbx@ddbx"]enabled = true

Try: "What did UK directors buy today?", "Any insider buying at Dunelm?", "What has Congress traded in NVDA?".

Once this repo is on GitHub: codex plugin marketplace add jonwillington/ddbx-plugin.

Test in ChatGPT

  1. Settings → Security and login → turn on Developer mode.

  2. ChatGPT Plugins → + → server URL https://api.ddbx.uk/mcp, authentication None.

  3. Copy the plugin_asdk_app_… id from the browser URL.

  4. To bundle the skills with it, add plugins/ddbx/.app.json:

    json
    { "apps": { "ddbx": { "plugin_asdk_app_<id>": {} } } }

    and "apps": "./.app.json" inside extensions.com.openai in plugin.json.

  5. Test in a Work chat with @ddbx.

Publish

  • Your workspace: ChatGPT Plugins → Personal → the plugin's ⋯ menu → Publish. This does not list it publicly.
  • Public directory: the submission portal. Needs a verified developer identity, and the domain challenge served at https://api.ddbx.uk/.well-known/openai-apps-challenge (a ddbx-data change). Listing copy and the required test cases are in SUBMISSION.md.

Source: README.md at commit 2805719

Tools

6

search_dealings

Search insider dealings

List recent insider share dealings in one market, newest first. By default only filings ddbx rated as signal (significant, noteworthy or minor); set signal_only=false for every screened open-market filing. Filter by ticker and by disclosure date.

Parameterslimitsincebeforemarketrequiredtickersignal_only

get_dealing

Get one insider dealing

One filing by the id returned from search_dealings or get_company (e.g. "UK:…", "US:f4-…").

Parametersidrequired

get_company

Insider activity at one company

Recent insider dealings at one UK- or US-listed company, with a short description of the business and a link to its ddbx company page.

Parameterslimitmarketrequiredtickerrequired

get_daily_summary

Daily insider-dealing summary

ddbx's written recap of a trading day's insider dealings (UK or US), with the filings it cites. Omit date for the latest.

Parametersdatemarketsession

fetch

Fetch a ddbx filing

The full thin-tier record for one id returned by search.

Parametersidrequired

Version history

1
  1. v1.0.0LatestSep 21, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts