Blackbook Protocol Advisor

Official25 tools

by koynlabs

Purchaser-gated MCP for Vault, HMRC TRS, 95/5 equity, and Companies House PSC.

Blackbook Protocol Advisor MCP

This MCP server provides a purchaser-gated interface for accessing services tied to Vault, HMRC TRS, 95/5 equity, and Companies House PSC. It is listed publicly for the Blackbook Protocol Advisor, while the product implementation remains in a private Blackbook app.

🛠️ Key Features

Purchaser-gated MCP
Supports Vault, HMRC TRS, 95/5 equity, and Companies House PSC
Exposes 25 tools

🚀 Use Cases

Integrate MCP clients with Blackbook-related procurement-eligible workflows
Retrieve or process information for Vault, HMRC TRS, 95/5 equity, and Companies House PSC

⚡ Developer Benefits

Connect MCP clients to https://theblackbook.pro using Streamable HTTP + OAuth
/mcp is an alias endpoint for access

⚠️ Limitations

Product source is not public; the listing is GitHub-backed while the app source is private

Captured live from the server via tools/list.

search_book

REQUIRED before substantive Protocol answers. Search approved Blackbook Protocol passages and return cited excerpts. Prefer Protocol vocabulary from hits over generic UK legal advice. Returns ranked results plus the educational boundary.

Parameters2

query	string	required	Search text using Protocol terms. Example: 95/5 equity split Vault PSC trustees
limit	integer	optional	Maximum number of cited excerpts to return. Default 5. Example: 5

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search text using Protocol terms. Example: 95/5 equity split Vault PSC trustees"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Maximum number of cited excerpts to return. Default 5. Example: 5"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_module_playbook

REQUIRED when coaching setup. Return the ordered Protocol checklist for a module. For 95/5 / share transfer into the Trust use equity_95_5 (not a freestyle solicitor checklist). Modules: vault, trs, equity_95_5, psc, banking, ip, philosophy, legacy, property.

Parameters1

module

string

required

Protocol module id. Example: equity_95_5

Raw schema

{
  "type": "object",
  "properties": {
    "module": {
      "type": "string",
      "enum": [
        "vault",
        "trs",
        "equity_95_5",
        "psc",
        "banking",
        "ip",
        "philosophy",
        "legacy",
        "property"
      ],
      "description": "Protocol module id. Example: equity_95_5"
    }
  },
  "required": [
    "module"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_skills

List Protocol Architect workflow skills (Vault, TRS, 95/5, PSC, portal co-pilot). Call when the Owner asks how to set something up; then get_skill for the matching workflow.

Parameters1

query

string

optional

Optional text to filter skill names or descriptions. Example: psc

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional text to filter skill names or descriptions. Example: psc"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_skill

Load a Protocol workflow skill as markdown. Names: establish-vault-trust, register-trust-trs, implement-95-5-equity-split, update-psc-companies-house, run-portal-copilot.

Parameters1

name

string

required

Skill name from list_skills. Example: implement-95-5-equity-split

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "enum": [
        "establish-vault-trust",
        "register-trust-trs",
        "implement-95-5-equity-split",
        "update-psc-companies-house",
        "run-portal-copilot"
      ],
      "description": "Skill name from list_skills. Example: implement-95-5-equity-split"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_modules

List available Protocol advisor modules in coaching order.

Parameters1

query

string

optional

Optional text to filter module id or title. Example: vault

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional text to filter module id or title. Example: vault"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_hmrc_guidance

Retrieve approved GOV.UK/HMRC trust and inheritance-tax guidance by topic. Returns a title, official URL, and short summary. Not a live scrape of GOV.UK.

Parameters2

topic	string	required	Guidance topic. Example: trs or inheritance tax
jurisdiction	string	optional	Jurisdiction filter. Example: UK

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "description": "Guidance topic. Example: trs or inheritance tax"
    },
    "jurisdiction": {
      "type": "string",
      "description": "Jurisdiction filter. Example: UK"
    }
  },
  "required": [
    "topic"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_companies_house_guidance

Retrieve approved Companies House / PSC / WebFiling guidance. PSC filings name individuals (trustees), never the Trust itself.

Parameters1

topic

string

required

Guidance topic. Example: psc or webfiling

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "description": "Guidance topic. Example: psc or webfiling"
    }
  },
  "required": [
    "topic"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

run_trust_intake

Validate a structured trust setup intake and return missing facts, Protocol warnings, and next modules. Call before drafting forms or opening portals.

Parameters12

jurisdiction	string	required	Governing law of the trust. Example: England and Wales
objective	string	required	Why the Owner is setting up the Vault. Example: Family wealth planning
assets	string	required	Assets intended for the Trust. Example: 95 ordinary shares in Example Ltd
assetValue	string	optional	Optional indicative value of those assets. Example: 100000 GBP
settlor	string	required	Person settling the Trust. Example: Alex Example
parties	string	required	Trustees and beneficiaries in Protocol terms. Example: Alex Example (Lead Trustee); Class: children
existingArrangements	string	optional	Existing companies, trusts, or wills that affect setup. Example: Sole shareholder of Example Ltd
deadlines	string	optional	Known filing or lender deadlines. Example: TRS within 90 days of the deed
questions	string	optional	Owner questions the Architect should address. Example: Can the Trust be named as PSC?
companyName	string	optional	Engine (limited company) name. Example: Example Ltd
companyNumber	string	optional	Companies House number. Example: 12345678
trustName	string	optional	Vault / settlement name. Example: Example Family Settlement 2026

Raw schema

{
  "type": "object",
  "properties": {
    "jurisdiction": {
      "type": "string",
      "description": "Governing law of the trust. Example: England and Wales"
    },
    "objective": {
      "type": "string",
      "description": "Why the Owner is setting up the Vault. Example: Family wealth planning"
    },
    "assets": {
      "type": "string",
      "description": "Assets intended for the Trust. Example: 95 ordinary shares in Example Ltd"
    },
    "assetValue": {
      "type": "string",
      "description": "Optional indicative value of those assets. Example: 100000 GBP"
    },
    "settlor": {
      "type": "string",
      "description": "Person settling the Trust. Example: Alex Example"
    },
    "parties": {
      "type": "string",
      "description": "Trustees and beneficiaries in Protocol terms. Example: Alex Example (Lead Trustee); Class: children"
    },
    "existingArrangements": {
      "type": "string",
      "description": "Existing companies, trusts, or wills that affect setup. Example: Sole shareholder of Example Ltd"
    },
    "deadlines": {
      "type": "string",
      "description": "Known filing or lender deadlines. Example: TRS within 90 days of the deed"
    },
    "questions": {
      "type": "string",
      "description": "Owner questions the Architect should address. Example: Can the Trust be named as PSC?"
    },
    "companyName": {
      "type": "string",
      "description": "Engine (limited company) name. Example: Example Ltd"
    },
    "companyNumber": {
      "type": "string",
      "description": "Companies House number. Example: 12345678"
    },
    "trustName": {
      "type": "string",
      "description": "Vault / settlement name. Example: Example Family Settlement 2026"
    }
  },
  "required": [
    "jurisdiction",
    "objective",
    "assets",
    "settlor",
    "parties"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

draft_form_answers

Draft preparation notes for TRS, IHT100, IHT400, and related professional-review questions from a completed intake. Label as a Protocol guide for solicitor execution.

Parameters2

intake	object	required	Structured Owner facts for Protocol coaching and portal field mapping
formFamily	string	optional	Form family to draft against. Example: TRS

Raw schema

{
  "type": "object",
  "properties": {
    "intake": {
      "type": "object",
      "properties": {
        "jurisdiction": {
          "type": "string",
          "description": "Governing law of the trust. Example: England and Wales"
        },
        "objective": {
          "type": "string",
          "description": "Why the Owner is setting up the Vault. Example: Family wealth planning"
        },
        "assets": {
          "type": "string",
          "description": "Assets intended for the Trust. Example: 95 ordinary shares in Example Ltd"
        },
        "assetValue": {
          "type": "string",
          "description": "Optional indicative value of those assets. Example: 100000 GBP"
        },
        "settlor": {
          "type": "string",
          "description": "Person settling the Trust. Example: Alex Example"
        },
        "parties": {
          "type": "string",
          "description": "Trustees and beneficiaries in Protocol terms. Example: Alex Example (Lead Trustee); Class: children"
        },
        "existingArrangements": {
          "type": "string",
          "description": "Existing companies, trusts, or wills that affect setup. Example: Sole shareholder of Example Ltd"
        },
        "deadlines": {
          "type": "string",
          "description": "Known filing or lender deadlines. Example: TRS within 90 days of the deed"
        },
        "questions": {
          "type": "string",
          "description": "Owner questions the Architect should address. Example: Can the Trust be named as PSC?"
        },
        "companyName": {
          "type": "string",
          "description": "Engine (limited company) name. Example: Example Ltd"
        },
        "companyNumber": {
          "type": "string",
          "description": "Companies House number. Example: 12345678"
        },
        "trustName": {
          "type": "string",
          "description": "Vault / settlement name. Example: Example Family Settlement 2026"
        }
      },
      "additionalProperties": true,
      "description": "Structured Owner facts for Protocol coaching and portal field mapping"
    },
    "formFamily": {
      "type": "string",
      "enum": [
        "TRS",
        "IHT100",
        "IHT400",
        "unknown"
      ],
      "description": "Form family to draft against. Example: TRS"
    }
  },
  "required": [
    "intake"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

prepare_portal_fill

Map intake facts to a fill_fields payload for TRS or Companies House PSC. Secrets (auth code) are listed but never filled. Call after Owner login; align labels with list_fillable_fields. Never maps the Trust as a PSC organisation.

Parameters2

intake	object	required	Structured Owner facts for Protocol coaching and portal field mapping
formFamily	string	optional	Portal family to map. Example: COMPANIES_HOUSE_PSC

Raw schema

{
  "type": "object",
  "properties": {
    "intake": {
      "type": "object",
      "properties": {
        "jurisdiction": {
          "type": "string",
          "description": "Governing law of the trust. Example: England and Wales"
        },
        "objective": {
          "type": "string",
          "description": "Why the Owner is setting up the Vault. Example: Family wealth planning"
        },
        "assets": {
          "type": "string",
          "description": "Assets intended for the Trust. Example: 95 ordinary shares in Example Ltd"
        },
        "assetValue": {
          "type": "string",
          "description": "Optional indicative value of those assets. Example: 100000 GBP"
        },
        "settlor": {
          "type": "string",
          "description": "Person settling the Trust. Example: Alex Example"
        },
        "parties": {
          "type": "string",
          "description": "Trustees and beneficiaries in Protocol terms. Example: Alex Example (Lead Trustee); Class: children"
        },
        "existingArrangements": {
          "type": "string",
          "description": "Existing companies, trusts, or wills that affect setup. Example: Sole shareholder of Example Ltd"
        },
        "deadlines": {
          "type": "string",
          "description": "Known filing or lender deadlines. Example: TRS within 90 days of the deed"
        },
        "questions": {
          "type": "string",
          "description": "Owner questions the Architect should address. Example: Can the Trust be named as PSC?"
        },
        "companyName": {
          "type": "string",
          "description": "Engine (limited company) name. Example: Example Ltd"
        },
        "companyNumber": {
          "type": "string",
          "description": "Companies House number. Example: 12345678"
        },
        "trustName": {
          "type": "string",
          "description": "Vault / settlement name. Example: Example Family Settlement 2026"
        }
      },
      "additionalProperties": true,
      "description": "Structured Owner facts for Protocol coaching and portal field mapping"
    },
    "formFamily": {
      "type": "string",
      "enum": [
        "TRS",
        "COMPANIES_HOUSE_PSC"
      ],
      "description": "Portal family to map. Example: COMPANIES_HOUSE_PSC"
    }
  },
  "required": [
    "intake"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

generate_review_bundle

Generate a cited professional-review bundle from a completed intake for the Owner to take to a solicitor or CTA.

Parameters2

intake	object	required	Structured Owner facts for Protocol coaching and portal field mapping
format	string	optional	Bundle format. Example: markdown

Raw schema

{
  "type": "object",
  "properties": {
    "intake": {
      "type": "object",
      "properties": {
        "jurisdiction": {
          "type": "string",
          "description": "Governing law of the trust. Example: England and Wales"
        },
        "objective": {
          "type": "string",
          "description": "Why the Owner is setting up the Vault. Example: Family wealth planning"
        },
        "assets": {
          "type": "string",
          "description": "Assets intended for the Trust. Example: 95 ordinary shares in Example Ltd"
        },
        "assetValue": {
          "type": "string",
          "description": "Optional indicative value of those assets. Example: 100000 GBP"
        },
        "settlor": {
          "type": "string",
          "description": "Person settling the Trust. Example: Alex Example"
        },
        "parties": {
          "type": "string",
          "description": "Trustees and beneficiaries in Protocol terms. Example: Alex Example (Lead Trustee); Class: children"
        },
        "existingArrangements": {
          "type": "string",
          "description": "Existing companies, trusts, or wills that affect setup. Example: Sole shareholder of Example Ltd"
        },
        "deadlines": {
          "type": "string",
          "description": "Known filing or lender deadlines. Example: TRS within 90 days of the deed"
        },
        "questions": {
          "type": "string",
          "description": "Owner questions the Architect should address. Example: Can the Trust be named as PSC?"
        },
        "companyName": {
          "type": "string",
          "description": "Engine (limited company) name. Example: Example Ltd"
        },
        "companyNumber": {
          "type": "string",
          "description": "Companies House number. Example: 12345678"
        },
        "trustName": {
          "type": "string",
          "description": "Vault / settlement name. Example: Example Family Settlement 2026"
        }
      },
      "additionalProperties": true,
      "description": "Structured Owner facts for Protocol coaching and portal field mapping"
    },
    "format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "description": "Bundle format. Example: markdown"
    }
  },
  "required": [
    "intake"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_risk_flags

Return legal, tax, and practical red flags detected from customer facts (settlor-as-beneficiary, lender consent, offshore, time pressure).

Parameters1

intake

object

required

Structured Owner facts for Protocol coaching and portal field mapping

Raw schema

{
  "type": "object",
  "properties": {
    "intake": {
      "type": "object",
      "properties": {
        "jurisdiction": {
          "type": "string",
          "description": "Governing law of the trust. Example: England and Wales"
        },
        "objective": {
          "type": "string",
          "description": "Why the Owner is setting up the Vault. Example: Family wealth planning"
        },
        "assets": {
          "type": "string",
          "description": "Assets intended for the Trust. Example: 95 ordinary shares in Example Ltd"
        },
        "assetValue": {
          "type": "string",
          "description": "Optional indicative value of those assets. Example: 100000 GBP"
        },
        "settlor": {
          "type": "string",
          "description": "Person settling the Trust. Example: Alex Example"
        },
        "parties": {
          "type": "string",
          "description": "Trustees and beneficiaries in Protocol terms. Example: Alex Example (Lead Trustee); Class: children"
        },
        "existingArrangements": {
          "type": "string",
          "description": "Existing companies, trusts, or wills that affect setup. Example: Sole shareholder of Example Ltd"
        },
        "deadlines": {
          "type": "string",
          "description": "Known filing or lender deadlines. Example: TRS within 90 days of the deed"
        },
        "questions": {
          "type": "string",
          "description": "Owner questions the Architect should address. Example: Can the Trust be named as PSC?"
        },
        "companyName": {
          "type": "string",
          "description": "Engine (limited company) name. Example: Example Ltd"
        },
        "companyNumber": {
          "type": "string",
          "description": "Companies House number. Example: 12345678"
        },
        "trustName": {
          "type": "string",
          "description": "Vault / settlement name. Example: Example Family Settlement 2026"
        }
      },
      "additionalProperties": true,
      "description": "Structured Owner facts for Protocol coaching and portal field mapping"
    }
  },
  "required": [
    "intake"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_implementation_modes

List Owner choices: self_serve (own browser + guidance) vs assisted (Browserbase live view + optional fill). Ask before starting co-pilot.

Parameters1

preferred

string

optional

Optional Owner preference if already stated. Example: self_serve

Raw schema

{
  "type": "object",
  "properties": {
    "preferred": {
      "type": "string",
      "enum": [
        "self_serve",
        "assisted"
      ],
      "description": "Optional Owner preference if already stated. Example: self_serve"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_self_serve_portal

Self-serve path: return the official portal URL plus Protocol checklist for the Owner’s own browser. Present portalUrl as a clickable markdown link (MCP cannot launch local browsers). Do not start Browserbase.

Parameters1

portalId

string

required

Allowlisted official portal. Example: trs for HMRC Trust Registration Service

Raw schema

{
  "type": "object",
  "properties": {
    "portalId": {
      "type": "string",
      "enum": [
        "trs",
        "trs_manage",
        "companies_house_webfiling",
        "companies_house_psc"
      ],
      "description": "Allowlisted official portal. Example: trs for HMRC Trust Registration Service"
    }
  },
  "required": [
    "portalId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

start_browser_session

ASSISTED mode only. Start a fresh ephemeral Browserbase (or mock) co-pilot session. Returns liveViewUrl — no purchaser email. If Owner prefers their own browser, use get_self_serve_portal instead.

Parameters1

reason

string

optional

Why assisted mode is needed. Example: Owner asked for live TRS fill help

Raw schema

{
  "type": "object",
  "properties": {
    "reason": {
      "type": "string",
      "description": "Why assisted mode is needed. Example: Owner asked for live TRS fill help"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

open_portal

Navigate the assisted session to an allowlisted portal: trs, trs_manage, companies_house_webfiling, or companies_house_psc.

Parameters2

sessionId	string	required	Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789
portalId	string	required	Allowlisted official portal. Example: trs for HMRC Trust Registration Service

Raw schema

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789"
    },
    "portalId": {
      "type": "string",
      "enum": [
        "trs",
        "trs_manage",
        "companies_house_webfiling",
        "companies_house_psc"
      ],
      "description": "Allowlisted official portal. Example: trs for HMRC Trust Registration Service"
    }
  },
  "required": [
    "sessionId",
    "portalId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

explain_current_screen

Summarise the current portal page: URL, text excerpt, fillable fields, Protocol hint, signedInLikely.

Parameters1

sessionId

string

required

Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789

Raw schema

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789"
    }
  },
  "required": [
    "sessionId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_fillable_fields

Inventory visible non-secret form controls (label/name/type) on the current portal page. Use to align prepare_portal_fill keys.

Parameters1

sessionId

string

required

Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789

Raw schema

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789"
    }
  },
  "required": [
    "sessionId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

fill_fields

Fill non-secret form fields (label/placeholder/name). Never passwords, OTPs, or Companies House auth codes.

Parameters2

sessionId	string	required	Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789
fields	object	required	Map of visible field label, placeholder, or name to a non-secret value. Example: {"Trust name":"Example Family Settlement 2026"}

Raw schema

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789"
    },
    "fields": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Map of visible field label, placeholder, or name to a non-secret value. Example: {\"Trust name\":\"Example Family Settlement 2026\"}"
    }
  },
  "required": [
    "sessionId",
    "fields"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

request_user_action

Pause for Owner login, CAPTCHA, 2FA, or review in the Browserbase live view. Never ask the Owner to paste passwords into chat.

Parameters2

sessionId	string	required	Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789
action	string	required	Why the Owner must use the live view. Example: login

Raw schema

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789"
    },
    "action": {
      "type": "string",
      "enum": [
        "login",
        "captcha",
        "2fa",
        "review"
      ],
      "description": "Why the Owner must use the live view. Example: login"
    }
  },
  "required": [
    "sessionId",
    "action"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

wait_for_user_ready

After request_user_action(login|2fa), poll until the page leaves the sign-in surface (or timeout). Then continue fill.

Parameters3

sessionId	string	required	Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789
timeoutMs	integer	optional	How long to wait for sign-in in milliseconds. Default 90000. Example: 90000
pollMs	integer	optional	Polling interval in milliseconds. Default 3000. Example: 3000

Raw schema

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789"
    },
    "timeoutMs": {
      "type": "integer",
      "minimum": 5000,
      "maximum": 180000,
      "description": "How long to wait for sign-in in milliseconds. Default 90000. Example: 90000"
    },
    "pollMs": {
      "type": "integer",
      "minimum": 1000,
      "maximum": 10000,
      "description": "Polling interval in milliseconds. Default 3000. Example: 3000"
    }
  },
  "required": [
    "sessionId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

prepare_submit_confirmation

Create a one-time confirmation token required before confirm_and_submit. Show the token to the human Owner; do not submit without it.

Parameters1

sessionId

string

required

Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789

Raw schema

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789"
    }
  },
  "required": [
    "sessionId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

confirm_and_submit

Submit the current portal form only after the human provides a valid one-time confirmationToken from prepare_submit_confirmation. This can file on a government portal.

Parameters2

sessionId	string	required	Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789
confirmationToken	string	required	One-time token the Owner typed from prepare_submit_confirmation. Example: 7K2Q9M

Raw schema

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789"
    },
    "confirmationToken": {
      "type": "string",
      "description": "One-time token the Owner typed from prepare_submit_confirmation. Example: 7K2Q9M"
    }
  },
  "required": [
    "sessionId",
    "confirmationToken"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

end_browser_session

Tear down the assisted browser session. No credentials are persisted. Safe to call more than once for the same id after expiry.

Parameters1

sessionId

string

required

Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789

Raw schema

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Ephemeral co-pilot session id returned by start_browser_session. Example: 8f3c2a1b-4d5e-6789-abcd-ef0123456789"
    }
  },
  "required": [
    "sessionId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_legal_boundary

Return the mandatory educational / non-advice boundary statement. Call when the Owner asks if this is legal advice.

Parameters1

audience

string

optional

Who will read the boundary line. Example: owner

Raw schema

{
  "type": "object",
  "properties": {
    "audience": {
      "type": "string",
      "description": "Who will read the boundary line. Example: owner"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md1 KBView on GitHub

Blackbook Protocol Advisor MCP

Public listing for the Blackbook Protocol Advisor remote MCP server.

Connect MCP clients to https://theblackbook.pro (Streamable HTTP + OAuth). /mcp is also an alias.

This repository is the GitHub-backed listing for the MCP Registry. Product source stays in the private Blackbook app.

Install

Tools (25)

search_bookget_module_playbooklist_skillsget_skilllist_modulesget_hmrc_guidanceget_companies_house_guidancerun_trust_intake

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://theblackbook.pro

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "blackbook-advisor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://theblackbook.pro"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Blackbook Protocol Advisor MCP

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_book

get_module_playbook

list_skills

get_skill

list_modules

get_hmrc_guidance

get_companies_house_guidance

run_trust_intake

draft_form_answers

prepare_portal_fill

generate_review_bundle

list_risk_flags

list_implementation_modes

get_self_serve_portal

start_browser_session

open_portal

explain_current_screen

list_fillable_fields

fill_fields

request_user_action

wait_for_user_ready

prepare_submit_confirmation

confirm_and_submit

end_browser_session

get_legal_boundary

Blackbook Protocol Advisor MCP

Install

Remote endpoint

Related servers