Interactive Explainer

How AI Connects to Your Systems

Model Context Protocol (MCP) โ€” the open standard that turns AI from a chatbot into a system that can query databases, call APIs, and take actions.

๐Ÿ“– Reference โšก Interactive ๐Ÿ”Œ MCP

๐Ÿ’ก Why Does AI Need MCP?

Without MCP, AI can only work with text you paste into it. It can't look things up, check databases, or take actions in your systems. MCP changes that.

๐Ÿ“‹

Without MCP

Export CSV โ†’ paste into chat โ†’ AI analyzes what you gave it. Manual, one-at-a-time.

๐Ÿ”Œ

With MCP

AI queries your database directly, gets exactly what it needs, analyzes live data. Automatic.

๐Ÿ”Œ

USB-C for AI

Just as USB-C connects any device to any peripheral, MCP connects any AI to any data source.

๐ŸŒ

Open Standard

Works with Claude, ChatGPT, Kiro, Cursor, VS Code โ€” build once, connect everywhere.

๐Ÿฆ What MCP Means for Insurance Teams

Your team works with databases, spreadsheets, document stores, and internal APIs every day. MCP lets AI access these systems the same way you do โ€” but faster.

Today (Manual)With MCP (Automated)
Export claims data to CSV, paste into AIAI queries claims database directly
Open 50 medical reports one by oneAI scans the claims documents folder automatically
Check policy coverage across 3 different systemsAI checks all 3 systems in one request
Copy policyholder data, format it, paste itAI runs SQL query, gets exactly what it needs
Manually send alert when fraud detectedAI sends the alert automatically via MCP
๐Ÿ’ก
Key insight: MCP doesn't replace your systems โ€” it connects AI to them. Your databases, APIs, and tools stay exactly where they are. MCP just gives AI a way to talk to them.

โšก API vs MCP โ€” What's the Difference?

Both APIs and MCP let systems talk to each other. But they solve different problems and work at different levels. Here's the clearest way to think about it:

๐Ÿ”Œ

API (Application Programming Interface)

A contract between two systems. "Send me this request, I'll give you this response." Designed for programs to talk to programs.

๐Ÿง 

MCP (Model Context Protocol)

A contract between AI and systems. "Here are the tools I offer โ€” the AI decides when and how to use them." Designed for AI to discover and use capabilities.

The Key Difference: Who Decides?

AspectTraditional APIMCP
Who calls it?A developer writes code: fetch('/api/claims')The AI decides on its own: "I need claims data, let me call read_query"
DiscoveryDeveloper reads API docs, writes integration codeAI asks the server "what tools do you have?" and figures it out
FlexibilityFixed endpoints โ€” each use case needs a specific API callAI composes tools dynamically โ€” same tools, infinite use cases
Who builds it?Developers build and maintain integrationsConfigure once, AI handles the rest
Error handlingDeveloper codes retry logic, error parsingAI reads the error, adjusts its approach, tries again

๐Ÿฆ AnyCompany Example: Getting Claims Data

๐Ÿ”Œ With a Traditional API

A developer writes this code:

// Developer writes this const resp = await fetch( '/api/claims?status=pending' ); const data = await resp.json(); // Then format, display, handle errors...

Requires: developer time, API knowledge, error handling code, maintenance when API changes.

๐Ÿง  With MCP

You just ask in plain English:

// You type this in Kiro: "Show me all pending claims over $10K with their policy details" // AI automatically: โ†’ tools/call read_query SELECT * FROM claims WHERE status = 'pending' AND amount > 10000

Requires: MCP server configured (one-time JSON file). No code, no API knowledge needed.

๐Ÿ’ก
The analogy: An API is like a vending machine โ€” you press the exact button for what you want. MCP is like a personal assistant with access to the vending machine โ€” you say "I'm thirsty" and they figure out which button to press.

๐Ÿค They Work Together, Not Against Each Other

MCP doesn't replace APIs โ€” it wraps them so AI can use them. Many MCP servers are just thin wrappers around existing APIs.

ScenarioUse API directlyUse MCP
Building a web app that shows claims dashboardโœ… Yes โ€” your app code calls the APIโŒ No โ€” apps don't need AI reasoning
AI agent that investigates claims fraud patternsโŒ No โ€” AI can't call APIs on its ownโœ… Yes โ€” AI discovers and calls tools
Automated report that pulls from policy, claims, and underwriting databasesโš ๏ธ Possible but needs custom codeโœ… Yes โ€” AI queries all 3 via MCP
Slack bot that responds to commandsโœ… Yes โ€” fixed command โ†’ fixed responseโœ… Also works โ€” AI reasons about the request
Dashboard with real-time chartsโœ… Yes โ€” direct data pipelineโŒ No โ€” MCP is for AI, not dashboards
๐Ÿ”‘
Rule of thumb: If a human or program knows exactly what data it needs โ†’ use an API. If an AI needs to figure out what data it needs based on a question โ†’ use MCP. In practice, MCP servers often call APIs under the hood โ€” you just don't have to write the integration code.

๐Ÿ”ง MCP Architecture

MCP follows a simple client-server pattern. The AI application (Kiro) is the host. It creates clients that connect to servers. Each server provides access to a specific data source or tool.

๐Ÿค– MCP Host Kiro / Claude / Cursor
โ†’
๐Ÿ”— MCP Client One per server
โ†’
๐Ÿ—„๏ธ MCP Server Database / API / Files

Three Core Primitives

Every MCP server can expose three types of capabilities:

๐Ÿ”จ

Tools

Actions the AI can perform: run a SQL query, call an API, send a message. The AI decides when to use them.

๐Ÿ“ฆ

Resources

Data the AI can read: file contents, database schemas, API responses. Like giving the AI access to a document.

๐Ÿ’ฌ

Prompts

Reusable templates that structure how the AI interacts with the server. Like pre-built query patterns.

โš™๏ธ How Connection Works

When you configure an MCP server in Kiro, here's what happens under the hood:

StepWhat happensYou see
1. ConfigureYou add the server to .kiro/settings/mcp.jsonEdit a JSON file
2. ConnectKiro launches the MCP server process and negotiates capabilitiesGreen checkmark โœ… in MCP panel
3. DiscoverKiro asks the server "what tools do you have?" via tools/listTool names appear in the panel
4. UseWhen you ask a question, Kiro decides which tool to call and sends a tools/call requestAI response includes data from the server
๐Ÿ”
Two transport modes: MCP servers can run locally (on your machine, using stdio โ€” like the SQLite server in the lab) or remotely (on a server, using HTTP โ€” like a cloud API). The protocol is the same either way.

๐ŸŽฎ MCP Message Flow โ€” Interactive Demo

Watch messages flow through the full MCP architecture as you ask a question. Each step shows exactly what's happening between components.

Message Flow

Step 0 / 0
๐Ÿ‘ค
You
Plain English
๐Ÿค–
Kiro (Host)
AI reasoning
๐Ÿ”—
MCP Client
JSON-RPC 2.0
โš™๏ธ
MCP Server
mcp-server-sqlite
๐Ÿ—„๏ธ
Database
claims.db
Press Play or Step Forward to watch the message flow.

๐Ÿฆ MCP Servers for Insurance Teams

These are the most common MCP servers your team would use. You specify what connections are needed in the Agent Design Canvas โ€” your tech team configures the actual servers.

MCP ServerConnects toInsurance use caseSetup
SQLite / PostgreSQLDatabasesQuery policy data, claims history, underwriting recordsConfig only
FilesystemFile directoriesProcess folders of medical reports, scan claim documentsConfig only
Slack / TeamsTeam messagingSend alerts when fraud pattern detectedAPI key
Google Drive / S3Document storageRead policy wordings and product specs for RAG groundingOAuth / IAM
Email (SMTP)Email systemsSend claims decisions, escalation alertsSMTP config
Custom REST APIInternal servicesCall underwriting rules engine, claims adjudication APICustom build
๐Ÿ’ก
You design the recipe, your tech team sets up the kitchen. In the Agent Design Canvas, you specify "MCP connections needed: claims database, policy admin system, Slack for alerts." Your engineering team then configures the actual MCP servers. The open-source community has pre-built servers for most common systems.

โš™๏ธ Configuration Example

This is what an MCP configuration looks like in Kiro. It's a simple JSON file โ€” no code required:

// .kiro/settings/mcp.json { "mcpServers": { "claims-db": { "command": "uvx", "args": ["mcp-server-sqlite", "--db-path", "./claims.db"], "autoApprove": ["read_query", "list_tables"] } } }

That's it โ€” 7 lines of JSON. Kiro launches the SQLite MCP server, connects to it, and you can start querying the database in plain English.

๐Ÿ”— The Complete Kiro Stack

MCP is the fourth and final layer of the Kiro automation stack. Here's how all 4 layers work together:

๐Ÿ“‹ Steering
Global rules
โ†’
๐Ÿ› ๏ธ Skills
On-demand expertise
โ†’
โšก Hooks
Auto-triggers
โ†’
๐Ÿ”Œ MCP
Data connections

How They Work Together โ€” Claims Fraud Detection Example

LayerWhat it doesIn the fraud detection workflow
SteeringSets global rulesSGD currency, no PII (NRIC/policy numbers), APPROVE/FLAG/REJECT ratings
SkillDefines the investigation processClaims Fraud Investigator persona, investigation report format, guardrails
HookTriggers automaticallyNew claim flagged โ†’ run fraud investigation skill
MCPConnects to dataSQLite server โ†’ query policyholder profile, claims history, provider records
๐Ÿ”
The full automation loop: Flagged claim arrives โ†’ Hook detects it โ†’ Skill activates โ†’ MCP queries claims database โ†’ Investigation report generated โ†’ Claims adjuster reviews the recommendation. The AI handles the investigation; you make the decision.

๐Ÿ—บ๏ธ Your Workshop Journey

ModuleWhat you learnWhat you build
M1-M2What agents are, how they workUnderstanding of agent architecture
M3Workflow patterns (chain, parallel, route, orchestrate)Pattern selection for insurance workflows
M4-M5AWS tools, frameworks (Kiro, Strands, AgentCore)Hands-on with Kiro skills, hooks, MCP
M6Custom solutions, guardrails, evaluationWorking agent with database connection

The thread: Module 1's agent concepts โ†’ applied in Module 3's workflow patterns. Module 3's patterns โ†’ implemented in Module 5's hands-on labs. Module 4's tools โ†’ connected via Module 5's MCP. Everything builds on what came before.