English Français العربية

ddbx — insider dealings

Official registry Search and web

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http ddbx-insider-dealings 'https://api.ddbx.uk/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "ddbx-insider-dealings": {
            "type": "http",
            "url": "https://api.ddbx.uk/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ddbx plugin (ChatGPT + Codex)
  2. Connect
  3. Contract with ddbx-data
  4. Test in Codex
  5. Test in ChatGPT
  6. Publish

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 directly
plugins/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.png
SUBMISSION.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

codex plugin marketplace add ./          # from this repo root
codex plugin marketplace list

Then enable it in ~/.codex/config.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:

     { "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.

Frequently asked questions

What is ddbx — insider dealings?

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

How do I install ddbx — insider dealings?

It runs as a remote server. In Claude Code: claude mcp add --transport http ddbx-insider-dealings 'https://api.ddbx.uk/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does ddbx — insider dealings need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is ddbx — insider dealings open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains ddbx — insider dealings?

It is published by jonwillington. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.