> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mcp-use.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:

<CodeGroup>
  ```typescript TypeScript highlight={12-16} theme={null}
  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()
  ```
</CodeGroup>

## Retrieving Prompts

Prompts are retrieved using the `getPrompt` method:

<CodeGroup>
  ```typescript TypeScript highlight={10-15} theme={null}
  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()
  ```
</CodeGroup>

## Prompt Structure

Prompts return structured content with messages:

<CodeGroup>
  ```typescript TypeScript theme={null}
  // 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]`)
      }
  }
  ```
</CodeGroup>