Skip to content

Document dict-to-Message prompt migration in upgrade guides#3225

Merged
jlowin merged 1 commit intomainfrom
docs/upgrade-guide-dict-prompts
Feb 19, 2026
Merged

Document dict-to-Message prompt migration in upgrade guides#3225
jlowin merged 1 commit intomainfrom
docs/upgrade-guide-dict-prompts

Conversation

@jlowin
Copy link
Copy Markdown
Member

@jlowin jlowin commented Feb 19, 2026

Both the MCP SDK's bundled FastMCP 1.0 and standalone FastMCP v2 silently coerced raw dicts ({"role": "user", "content": "..."}) into prompt messages. v3 requires typed Message objects or plain strings, and raises TypeError for dicts. This bit our own integration tests (PrefectHQ/horizon-integration-tests#36), so it'll bite others too.

Adds the dict migration path to both upgrade guides (from-fastmcp-2 and from-mcp-sdk) with before/after examples and LLM prompt updates.

@marvin-context-protocol marvin-context-protocol Bot added the documentation Updates to docs, examples, or guides. Primary change is documentation-related. label Feb 19, 2026
@jlowin jlowin merged commit 9975e1c into main Feb 19, 2026
10 checks passed
@jlowin jlowin deleted the docs/upgrade-guide-dict-prompts branch February 19, 2026 00:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Updates to docs, examples, or guides. Primary change is documentation-related.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant