ddbx MCP server
Commit Sep 21, 2026Search rated insider dealings across the UK, US, Sweden, Netherlands, and US Congress.
Also known as jonwillington/ddbx-plugin, ddbx-plugin
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Sep 21, 2026
- License
- MIT
What is ddbx MCP?
ddbx searches rated insider dealings across the UK, US, Sweden, Netherlands, and US Congress.
Summary generated from the project's README
About ddbx MCP server
Monitoring rated insider trading activity across international markets is what ddbx enables for financial researchers and developers. By connecting to the remote MCP server, users can access data regarding insider dealings in the UK, US, Sweden, Netherlands, and the US Congress. The server is a read-only, thin-tier service that requires no API keys or authentication to use.
Developers can integrate this tool into various environments including Claude, Cursor, VS Code, and the Gemini CLI. The server provides specific tools such as search_dealings, get_dealing, get_company, and get_daily_summary to facilitate data retrieval. Because the server does not provide analysis prose, the assistant focuses on providing direct links to filings rather than interpreting the reasons behind a rating.
This setup is designed for quick integration via HTTP transport. It works with ChatGPT through developer mode and can be added to Codex via the plugin marketplace. The implementation ensures that users receive factual data from specific markets without the need for complex local configurations.
What you can do with it
- 1Track specific company activityAsk the assistant to find any insider buying activity for a particular company like Dunelm.
- 2Monitor congressional tradingQuery the assistant to see what trades members of the US Congress have made regarding specific stocks like NVDA.
- 3Review daily market summariesRequest a summary of the most important insider dealings that occurred in the UK or US during the day.
Written from the project's README. Every use case is checked against a quote from it.
How to install ddbx MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall ddbx MCP in Claude Code
$ claude mcp add --transport http ddbx-plugin https://api.ddbx.uk/mcpInstall ddbx MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ddbx-plugin": {
"url": "https://api.ddbx.uk/mcp"
}
}
}Install ddbx MCP in VS Code
.vscode/mcp.json
{
"servers": {
"ddbx-plugin": {
"type": "http",
"url": "https://api.ddbx.uk/mcp"
}
}
}Install ddbx MCP in VS Code CLI
$ code --add-mcp '{"name":"ddbx-plugin","type":"http","url":"https://api.ddbx.uk/mcp"}'Install ddbx MCP in Codex
$ codex mcp add ddbx-plugin --url https://api.ddbx.uk/mcpInstall ddbx MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.ddbx-plugin] url = "https://api.ddbx.uk/mcp"
Install ddbx MCP in Gemini CLI
$ gemini mcp add -s user --transport http ddbx-plugin https://api.ddbx.uk/mcpInstall ddbx MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"ddbx-plugin": {
"url": "https://api.ddbx.uk/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablejonwillington/ddbx-plugin is public and reachablegithub.com/jonwillington/ddbx-plugin ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-21github.com/jonwillington/ddbx-plugin ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 281 msPass
README
View on GitHubddbx 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 inddbx-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 perioddaily-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
ddbxwith 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
-
Settings → Security and login → turn on Developer mode.
-
ChatGPT Plugins → + → server URL
https://api.ddbx.uk/mcp, authentication None. -
Copy the
plugin_asdk_app_…id from the browser URL. -
To bundle the skills with it, add
plugins/ddbx/.app.json:{ "apps": { "ddbx": { "plugin_asdk_app_<id>": {} } } }and
"apps": "./.app.json"insideextensions.com.openaiinplugin.json. -
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 inSUBMISSION.md.
ddbx MCP questions
How do I add ddbx MCP to Claude Code?
Run claude mcp add --transport http ddbx-plugin https://api.ddbx.uk/mcp in your terminal. Add --scope user to make it available in every project.
How do I add ddbx MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does the ddbx MCP server require an API key?
No, the hosted server is public, read-only, and requires no authentication.
Can the assistant provide analysis on why a rating was given?
No, the assistant does not serve analysis prose and will link to filings instead of inventing reasons for a rating.