Skip to main content

​
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:
FieldTypeDescription
namestrPrompt identifier
descriptionstr | NoneWhat the prompt does
argumentslist | NoneRequired/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:
FieldTypeDescription
messageslistRendered message sequence
descriptionstr | NoneOptional 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"})