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.