{"name":"io.github.koynlabs/blackbook-advisor","slug":"koynlabs-blackbook-advisor","title":"Blackbook Protocol Advisor","description":"Purchaser-gated MCP for Vault, HMRC TRS, 95/5 equity, and Companies House PSC.","url":"https://mcp.market/server/koynlabs-blackbook-advisor","rating":null,"grade":"B","score":83,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":23,"stars":0,"forks":0,"downloads_week":null,"last_push_at":"2026-08-29T16:59:12.000Z","license":null},"uptime":{"percent":100,"checks":6,"ok":6,"last_checked_at":"2026-09-20T22:26:12.178Z","last_ok_at":"2026-09-20T22:26:12.178Z","latency_ms":360},"claimed":false,"transport":"remote","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/koynlabs/mcp-blackbook","website":"https://theblackbook.pro","version":"1.0.3","remotes":[{"type":"streamable-http","url":"https://theblackbook.pro"}],"packages":[],"tools":[{"name":"confirm_and_submit","description":"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.","write_action":true,"price_micros":0,"input_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#"}},{"name":"draft_form_answers","description":"Draft preparation notes for TRS, IHT100, IHT400, and related professional-review questions from a completed intake. Label as a Protocol guide for solicitor execution.","write_action":false,"price_micros":0,"input_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#"}},{"name":"end_browser_session","description":"Tear down the assisted browser session. No credentials are persisted. Safe to call more than once for the same id after expiry.","write_action":false,"price_micros":0,"input_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#"}},{"name":"explain_current_screen","description":"Summarise the current portal page: URL, text excerpt, fillable fields, Protocol hint, signedInLikely.","write_action":false,"price_micros":0,"input_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#"}},{"name":"fill_fields","description":"Fill non-secret form fields (label/placeholder/name). Never passwords, OTPs, or Companies House auth codes.","write_action":false,"price_micros":0,"input_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#"}},{"name":"generate_review_bundle","description":"Generate a cited professional-review bundle from a completed intake for the Owner to take to a solicitor or CTA.","write_action":false,"price_micros":0,"input_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#"}},{"name":"get_companies_house_guidance","description":"Retrieve approved Companies House / PSC / WebFiling guidance. PSC filings name individuals (trustees), never the Trust itself.","write_action":false,"price_micros":0,"input_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#"}},{"name":"get_hmrc_guidance","description":"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.","write_action":false,"price_micros":0,"input_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#"}},{"name":"get_legal_boundary","description":"Return the mandatory educational / non-advice boundary statement. Call when the Owner asks if this is legal advice.","write_action":false,"price_micros":0,"input_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#"}},{"name":"get_module_playbook","description":"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.","write_action":false,"price_micros":0,"input_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#"}},{"name":"get_self_serve_portal","description":"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.","write_action":false,"price_micros":0,"input_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#"}},{"name":"get_skill","description":"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.","write_action":false,"price_micros":0,"input_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#"}},{"name":"list_fillable_fields","description":"Inventory visible non-secret form controls (label/name/type) on the current portal page. Use to align prepare_portal_fill keys.","write_action":false,"price_micros":0,"input_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#"}},{"name":"list_implementation_modes","description":"List Owner choices: self_serve (own browser + guidance) vs assisted (Browserbase live view + optional fill). Ask before starting co-pilot.","write_action":false,"price_micros":0,"input_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#"}},{"name":"list_modules","description":"List available Protocol advisor modules in coaching order.","write_action":false,"price_micros":0,"input_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#"}},{"name":"list_risk_flags","description":"Return legal, tax, and practical red flags detected from customer facts (settlor-as-beneficiary, lender consent, offshore, time pressure).","write_action":false,"price_micros":0,"input_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#"}},{"name":"list_skills","description":"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.","write_action":false,"price_micros":0,"input_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#"}},{"name":"open_portal","description":"Navigate the assisted session to an allowlisted portal: trs, trs_manage, companies_house_webfiling, or companies_house_psc.","write_action":false,"price_micros":0,"input_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#"}},{"name":"prepare_portal_fill","description":"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.","write_action":false,"price_micros":0,"input_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#"}},{"name":"prepare_submit_confirmation","description":"Create a one-time confirmation token required before confirm_and_submit. Show the token to the human Owner; do not submit without it.","write_action":true,"price_micros":0,"input_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#"}},{"name":"request_user_action","description":"Pause for Owner login, CAPTCHA, 2FA, or review in the Browserbase live view. Never ask the Owner to paste passwords into chat.","write_action":false,"price_micros":0,"input_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#"}},{"name":"run_trust_intake","description":"Validate a structured trust setup intake and return missing facts, Protocol warnings, and next modules. Call before drafting forms or opening portals.","write_action":true,"price_micros":0,"input_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#"}},{"name":"search_book","description":"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.","write_action":false,"price_micros":0,"input_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#"}},{"name":"start_browser_session","description":"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.","write_action":false,"price_micros":0,"input_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#"}},{"name":"wait_for_user_ready","description":"After request_user_action(login|2fa), poll until the page leaves the sign-in surface (or timeout). Then continue fill.","write_action":false,"price_micros":0,"input_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#"}}],"scan":{"score":83,"grade":"B","scanned_at":"2026-09-20T20:59:35.697Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-20T20:59:35.679Z","components":{"code":{"score":-1,"max":25,"notes":["remote-only server, no package to scan"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 568ms"]},"poisoning":{"score":15,"max":15,"notes":["25 tool descriptions checked"]},"auth":{"score":3,"max":15,"notes":["open endpoint exposes 3 write-action tools with no auth"]},"maintenance":{"score":15,"max":15,"notes":["last push 22 days ago"]},"identity":{"score":9,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[{"id":"auth.open-write","severity":"high","component":"auth","title":"Write-action tools reachable without authentication"}],"inputs":{"probes":[{"url":"https://theblackbook.pro","reachable":true,"authRequired":false,"latencyMs":568,"serverInfo":{"name":"blackbook-advisor","version":"1.0.0"}}],"packages":[],"repo":{"found":true,"owner":"koynlabs","repo":"mcp-blackbook","archived":false,"pushedAt":"2026-08-29T16:59:12Z","stars":0,"forks":0,"openIssues":0,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/202906270?v=4","ownerCreatedAt":"2025-03-12T06:28:50Z"},"icon":{"url":"https://theblackbook.pro/logo.png","source":"registry","width":512,"height":512},"presence":{"stars":0,"forks":0,"downloadsWeek":null,"license":null,"lastPushAt":"2026-08-29T16:59:12.000Z","score":23}}}},"grade_history":[],"reviews":[]}