Skip to main content
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: 
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: 
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: 
// 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]`)
    }
}