Skip to content

MCP Tool Reference

The Blueprint MCP server provides 39 tools and 3 resources for AI assistants and automated workflows. Use get_tool_cheatsheet() as your entry point.

Overview by category

Search & Answers

Tool When to use Next step
answer_question Answer a substantive question about the Blueprint get_template or get_phase_guidance
search_content Search documentation by keyword, phase, layer, or type answer_question or get_template
lookup_terminology Look up Blueprint concepts and definitions answer_question

Templates & Phase Content

Tool When to use Next step
get_template Retrieve a template by name list_template_placeholders
get_template_for_context Recommended templates for a role and phase get_template
get_phase_guidance Objectives, activities or deliverables per phase get_template_for_context
template_advisor Which templates do I need? (role + phase) get_template
select_template Select the best template from multiple candidates get_template
list_template_placeholders Show the fill-in fields in a template fill_template
fill_template Fill in a template with provided values
fill_template_with_session_tool Fill a template using session data

Analysis & Decision-making

Tool When to use Next step
classify_risk Classify an AI system (EU AI Act risk tiers) compliance_checklist
check_gate_readiness Evidence gap analysis for a specific gate (1–4) gate_review_intake
select_collaboration_mode Choose the right Collaboration Mode (1–5) get_phase_guidance
get_project_type Classify the project as Type A or B project_setup_risk
get_guidance_for_profile Recommendations based on organisation profile get_phase_guidance
can_enter_phase Check whether a project may enter the next phase gate_review_intake
validate_project_context Validate project data against Blueprint requirements project_setup_charter

Terminology & Utilities

Tool When to use Next step
get_workflow_status Retrieve the status of the active workflow can_enter_phase
get_tool_cheatsheet Navigate to the right tool based on intent (see table)
reload_content Reload the documentation index (after updates)
list_sources List authoritative sources used in Blueprint answer_question

Guided Workflows

Project Setup (3 steps)

Step Tool What you provide What you get back
1 project_setup_intake Project description Type A/B form + risk questions
2 project_setup_risk B1/B2/B3 scores (0–10) Risk score (green/amber/red) + Collaboration Mode advice
3 project_setup_charter Project name, team, budget, timeline Pre-filled Project Charter

Gate Review (2 steps)

Step Tool What you provide What you get back
1 gate_review_intake Gate number (1–4) + evidence items Evidence gap analysis
2 gate_review_report Gate number + gaps + actions Go/No-Go summary for the Guardian

Compliance (2 steps)

Step Tool What you provide What you get back
1 compliance_intake System description EU AI Act risk tier + obligations
2 compliance_checklist System description + risk tier Article-referenced checklist

Sessions & Project Tracking

Tool When to use
session_start Start a new workflow session for a project
session_get_state Retrieve the current session state
session_record_artifact Register an artifact in the session (document, test result)
list_projects Overview of all active project sessions

Lead Management (GDPR-compliant)

Tool When to use
submit_lead Submit a new lead intake record with explicit consent
delete_lead_data Erase all lead data for an email (right to erasure)
export_lead_data Export all lead data for an email (right of access)

Reminders

Tool When to use
schedule_reminder Schedule a reminder for a session
list_reminders List all reminders for a session
cancel_reminder Cancel a pending reminder

Resources (read-only)

Resource URI Content
blueprint://module/{path} Full content of a Blueprint module by path
blueprint://phase/{phase_id}/overview Complete overview of a phase (objectives + activities + deliverables)
blueprint://glossary The complete Blueprint glossary

Tool details

answer_question

Answers a substantive question via semantic search (RAG) followed by keyword fallback.

answer_question(question: str, output_format: str = "markdown") -> str

Returns up to 3 results: the best match with full content, the rest with summaries.

search_content

Search documentation by keyword with optional filters.

search_content(query: str, type: str | None = None, phase: int | None = None, layer: int | None = None, tag: str | None = None, output_format: str = "markdown") -> str

lookup_terminology

Look up a term in the Blueprint glossary.

lookup_terminology(term: str, output_format: str = "markdown") -> str

get_template

Retrieve a template by name (exact or partial match).

get_template(name: str, output_format: str = "markdown") -> str

check_gate_readiness

Compare provided evidence against the required gate criteria.

check_gate_readiness(gate: int, evidence: list[str], output_format: str = "markdown") -> str

classify_risk

Classify an AI system into an EU AI Act risk tier.

classify_risk(system_description: str, output_format: str = "markdown") -> str

Returns: unacceptable / high / limited / minimal with obligations per tier.

compliance_checklist

Generate an article-referenced EU AI Act checklist.

compliance_checklist(description: str, risk_category: str, output_format: str = "markdown") -> str

Validation

risk_category is validated. Always use the English category name.

session_start

Start a session to track progress, artifacts, and gate results.

session_start(project_id: str, project_type: str, language: str = "en", output_format: str = "markdown") -> str

Returns a session_id for use in subsequent calls.

get_tool_cheatsheet

Returns a table of all tools, when to use them, and what the next step is.

get_tool_cheatsheet(intent: str = "", output_format: str = "markdown") -> str

submit_lead

Submit a new lead intake record with GDPR-compliant consent.

submit_lead(name: str, email: str, company: str, role: str, project_phase: str, help_request: str, consent_given: bool, policy_version: str = "1.0", output_format: str = "markdown") -> str

delete_lead_data

Erase all lead data for a given email (GDPR right to erasure).

delete_lead_data(email: str, output_format: str = "markdown") -> str

export_lead_data

Export all lead data for a given email (GDPR right of access).

export_lead_data(email: str, output_format: str = "markdown") -> str

schedule_reminder

Schedule a reminder for a session.

schedule_reminder(session_id: str, due_date: str, message: str, output_format: str = "markdown") -> str

list_reminders

List all reminders for a session.

list_reminders(session_id: str, output_format: str = "markdown") -> str

cancel_reminder

Cancel a pending reminder.

cancel_reminder(reminder_id: int, output_format: str = "markdown") -> str

list_sources

List all authoritative sources used in the Blueprint, with optional topic filter.

list_sources(topic: str = "", output_format: str = "markdown") -> str

Installation

Claude Code (CLI)

claude mcp add blueprint --transport http https://ai-delivery.io/mcp

Claude Desktop

{
  "mcpServers": {
    "blueprint": {
      "type": "http",
      "url": "https://ai-delivery.io/mcp"
    }
  }
}

Cursor / other MCP clients

Add an HTTP MCP server with URL https://ai-delivery.io/mcp.