Prompts

List and render prompts from MCP servers

Prompts are reusable message templates exposed by the server. A prompt can accept string-valued arguments and returns a sequence of messages you can feed into an LLM conversation. If you’re new to this: think of a prompt as a pre-written chat script stored on the server (like “summarize” or “code review”). Your client can list the available scripts, then render one into actual messages (optionally filling in arguments like "language": "python").

List prompts

Discover available prompts:

from dedalus_mcp.client import open_connection

async with open_connection("http://127.0.0.1:8000/mcp") as client:
    prompts = await client.list_prompts()

    for p in prompts.prompts:
        print(f"{p.name}: {p.description}")

Prompt schema

Each prompt includes:

Field	Type	Description
`name`	`str`	Prompt identifier
`description`	`str \| None`	What the prompt does
`arguments`	`list \| None`	Required/optional arguments

for p in prompts.prompts:
    print(f"Name: {p.name}")
    print(f"Description: {p.description}")
    if p.arguments:
        for arg in p.arguments:
            required = "(required)" if arg.required else "(optional)"
            print(f"  - {arg.name}: {arg.description} {required}")

Get a prompt

Render a prompt with arguments:

result = await client.get_prompt("summarize", {"style": "brief"})
print(result.messages)

Note: MCP prompt arguments are strings. If a server expects structured input (lists/dicts), it will usually ask you to pass a JSON string and parse it server-side.

Response structure

A rendered prompt returns a GetPromptResult:

Field	Type	Description
`messages`	`list`	Rendered message sequence
`description`	`str \| None`	Optional description

Each message has a role and a content block. Many prompts return text content; some may return non-text content blocks.

from dedalus_mcp import types

result = await client.get_prompt("code-review", {"language": "python"})

for msg in result.messages:
    content = msg.content
    if isinstance(content, types.TextContent):
        text = content.text
    else:
        text = f"<{content.type} content>"
    print(f"[{msg.role}] {text}")

Example: Code assistant

import asyncio
from dedalus_mcp.client import MCPClient
from dedalus_mcp import types

async def main():
    client = await MCPClient.connect("http://127.0.0.1:8000/mcp")
    try:
        prompts = await client.list_prompts()
        print("Available prompts:")
        for p in prompts.prompts:
            print(f"  - {p.name}: {p.description}")

        result = await client.get_prompt(
            "explain-code",
            {
                "language": "python",
                "code": "def fib(n): return n if n < 2 else fib(n-1) + fib(n-2)",
            },
        )

        print("\nRendered prompt:")
        for msg in result.messages:
            if isinstance(msg.content, types.TextContent):
                print(f"[{msg.role}] {msg.content.text}")
            else:
                print(f"[{msg.role}] <{msg.content.type} content>")

    finally:
        await client.close()

asyncio.run(main())

Prompts without arguments

Some prompts don’t require arguments:

result = await client.get_prompt("greeting")
# or explicitly:
result = await client.get_prompt("greeting", {})

Context manager

from dedalus_mcp.client import open_connection

async with open_connection("http://127.0.0.1:8000/mcp") as client:
    prompts = await client.list_prompts()
    result = await client.get_prompt("analyze", {"data": "sample"})

Python

TypeScript

Prompts

Prompts

List prompts

Prompt schema

Get a prompt

Response structure

Example: Code assistant

Prompts without arguments

Context manager

​Prompts

​List prompts

​Prompt schema

​Get a prompt

​Response structure

​Example: Code assistant

​Prompts without arguments

​Context manager

Prompts

List prompts

Prompt schema

Get a prompt

Response structure

Example: Code assistant

Prompts without arguments

Context manager