Skip to main content

Search the Commons

Type at least 2 letters. Use the arrow keys to move through results, Enter to open, Escape to close.

Ask a question instead: answers drawn from across the Commons, with links to the source. Or browse the site map.

Apply to your context · Use the Commons your way

Use the Commons your way: link, embed, connect, copy or ask

The Commons is open, so you can bring its content, data and tools to the places your people already work: your intranet, content and collaboration tools, your own branded copy, your systems through an open data API, and AI assistants through MCP and connectors.

In short: a plain English summary
  • This page shows ways to use this website in your own place.
  • You can link to it, or show it inside your own website.
  • You can make your own copy with your own name and colours.
  • Computer systems and helpers can read it too.

Find your route in three questions

1. Who is it for?
2. How much should look like yours?
3. What technical help do you have?

Compare the routes

RouteBest forEffortKeeping up to dateWhat you controlTechnical help neededStatus

How to use each route

Embed code builder

Embedded pages hide the Commons menu, footer and page links, show a small link back to the source, and can take your accent colour. Links inside the embedded page stay embedded.

Six-digit hex, for example 1d70b8. Leave empty to keep the Commons colours. Text in this colour must keep 4.5:1 contrast on white.

Preview the embedded page (opens in a new tab)

Open data API

Read-only JSON files at fixed addresses, rebuilt with every release. No key, no sign-in and no tracking. Start with api/index.json, which lists every file, its version and, for knowledge files, the owning role and last review date.

Example: read the site map in a web page
Example: read the frameworks in Python
Example: post new releases to a Teams channel with Power Automate
  1. Create a scheduled cloud flow (for example weekly).
  2. Add an HTTP action (or a feed action) that reads api/releases.json or feed.xml from the published Commons.
  3. Compare the first version with the one you stored last time; if it is new, post its title and items to your channel.
  4. Store the version you posted, so you only post each release once.

Check which connectors your organisation allows before you build the flow.

AI assistants, MCP and connectors

Set up the MCP server for an AI assistant, step by step
  1. Check your organisation allows the AI assistant you want to use, and that it can use local MCP servers.
  2. Get the toolkit: download or clone the repository, then install it with pip install -r requirements.txt in that folder.
  3. Add a local (standard input and output) MCP server to your assistant with the command python -m dqkit.mcp_server, started in the folder that holds the data you want it to read. Many assistants take a settings block like the one below.
  4. Ask the assistant to list its tools. You should see the tools listed below.
  5. Try: "Suggest starter rules for this CSV" or "Score this issue with the issues framework". Check the answers: the tools are deterministic, so the same input always gives the same result.

    

The server is read-only, only reads files inside the folder it starts in (or DQKIT_MCP_ROOT), and makes no network calls.

The toolkit's MCP tools

Guardrails for any AI use

Make it yours: audience, brand, language and tone

AspectHow to tailor it

Comms and collaboration

Share from any page

Every page has Share this page under its title: copy the link to the page or the section you are reading, share with your device, by email, to Microsoft Teams or LinkedIn, copy embed code, or print.

A tab in a Teams channel

  1. In the channel, select + to add a tab.
  2. Choose Website (if your organisation allows it).
  3. Paste the address of a Commons page, for example the playbook, and name the tab.

A search shortcut in your browser

  1. In your browser's search engine settings, add a new site search.
  2. Use the address with %s where the words go.
  3. Give it a short keyword, such as dq, then type dq and your words in the address bar.

Updates in your channels

Follow feed.xml in a feed reader or channel, or post releases automatically with a workflow (see the API examples).

Intranet and wiki spaces

Embed pages in SharePoint or Confluence spaces your teams already use, and link to sections from your own guidance so there is one source to maintain.

Licences and attribution