Phantom.Prompt (phantom_mcp v0.2.0)

View Source

The Model Context Protocol (MCP) provides a standardized way for servers to expose prompt templates to clients. Prompts allow servers to provide structured messages and instructions for interacting with language models. Clients can discover available prompts, retrieve their contents, and provide arguments to customize them.

https://modelcontextprotocol.io/specification/2025-03-26/server/prompts

Summary

Types

audio_content()
embedded_resource_content()
image_content()
json()
message()
response()
t()
text_content()

Functions

audio(data, mime_type)

Build an audio message for the prompt

build(attrs)

Build a prompt spec

embedded_resource(uri, resource)

Embedded resource reponse.

image(binary, mime_type)

Build an image message for the prompt

response(response)

Formats the response from an MCP Router to the MCP specification

response(response, prompt)

Construct a prompt response with the provided messages for the given prompt

text(data)

Build a text message for the prompt

to_json(prompt)

Represent a Prompt spec as json when listing the available prompts to clients.

Types

audio_content()

@type audio_content() :: %{
  type: :audio,
  data: base64_encoded :: String.t(),
  mimeType: String.t()
}

embedded_resource_content()

@type embedded_resource_content() :: %{
  type: :resource,
  resource: Phantom.Resource.response()
}

image_content()

@type image_content() :: %{
  type: :image,
  data: base64_encoded :: String.t(),
  mimeType: String.t()
}

json()

@type json() :: %{
  :name => String.t(),
  optional(:description) => String.t(),
  optional(:arguments) => %{required(String.t()) => String.t()}
}

message()

@type message() :: %{
  role: :assistant | :user,
  content:
    text_content()
    | image_content()
    | audio_content()
    | embedded_resource_content()
}

response()

@type response() :: %{description: String.t(), messages: [message()]}

t()

@type t() :: %Phantom.Prompt{
  arguments: [Phantom.Prompt.Argument.t()],
  completion_function: atom(),
  description: String.t(),
  function: atom(),
  handler: module(),
  meta: map(),
  name: String.t()
}

text_content()

@type text_content() :: %{type: :text, data: String.t()}

Functions

audio(data, mime_type)

@spec audio(binary(), String.t()) :: audio_content()

Build an audio message for the prompt

The provided binary will be base64-encoded.

build(attrs)

@spec build(map() | Keyword.t()) :: t()

Build a prompt spec

The Phantom.Router.prompt/3 macro will build these specs.

embedded_resource(uri, resource)

@spec embedded_resource(string_uri :: String.t(), map()) ::
  embedded_resource_content()

Embedded resource reponse.

image(binary, mime_type)

@spec image(binary(), String.t()) :: image_content()

Build an image message for the prompt

The provided binary will be base64-encoded.

response(response)

(macro)

Formats the response from an MCP Router to the MCP specification

Provide a keyword list of messages with a keyword list. The key should contain the role, and the value contain the message.

For example:

require Phantom.Prompt, as: Prompt
{:ok, uri, resource} = MyApp.MCP.Router.read_resource(session, :my_resource, 123)

Prompt.response([
  assistant: Prompt.audio(File.read!("foo.wav"), "audio/wav"),
  user: Prompt.text("Wow that was interesting"),
  assistant: Prompt.image(File.read!("bar.png"), "image/png"),
  user: Prompt.text("amazing"),
  assistant: Prompt.embedded_resource(uri, resource)
])

response(response, prompt)

@spec response([message()], t()) :: response()

Construct a prompt response with the provided messages for the given prompt

See response/1 macro version that do the same thing but will fetch the prompt spec from the current session.

text(data)

@spec text(String.t()) :: text_content()

Build a text message for the prompt

to_json(prompt)

@spec to_json(t()) :: json()

Represent a Prompt spec as json when listing the available prompts to clients.