Prompts

Use server-defined prompt templates

Prompts are reusable, parameterized templates that MCP servers provide for AI interactions. They standardize common workflows, enable consistent communication patterns, and help structure complex requests with well-defined parameters.

Listing Available Prompts

To see what prompts are available from a connected MCP server:

TypeScript

import { MCPClient } from 'mcp-use'

const client = new MCPClient({
    mcpServers: {
        // Your server definitions here
    }
})
await client.createAllSessions()

const session = client.getSession('my_server')

const prompts = await session.listPrompts()
    for (const prompt of prompts) {
    console.log(`Prompt: ${prompt.name}`)
    console.log(`Description: ${prompt.description}`)
}

await client.closeAllSessions()

Retrieving Prompts

Prompts are retrieved using the getPrompt method:

TypeScript

import { MCPClient } from 'mcp-use'

const client = new MCPClient({
    mcpServers: {
        // Your server definitions here
    }
})
await client.createAllSessions()

const result = await session.getPrompt('plan_vacation', {
    destination: 'Japan',
    duration: '2 weeks',
    budget: '$5000',
    interests: ['culture', 'food', 'nature']
})

console.log(`Prompt description: ${result.description}`)
for (const message of result.messages) {
    console.log(`Role: ${message.role}`)
    console.log(`Content: ${message.content.text}`)
}

await client.closeAllSessions()

Prompt Structure

Prompts return structured content with messages:

TypeScript

// Example of working with prompt results
const result = await session.getPrompt('code_review', { language: 'python' })

for (const message of result.messages) {
    // Messages have roles (e.g., "user", "assistant", "system")
    const role = message.role

    // Content can be text or other formats
    if ('text' in message.content) {
        const textContent = message.content.text
        console.log(`${role}: ${textContent}`)
    }

    // Handle other content types if needed
    if ('image' in message.content) {
        console.log(`${role}: [Image content]`)
    }
}