poppify-schema-introspect

Inspecting the deployed Poppify MCP schemas

MCP clients strip undeclared fields before forwarding to the server. If a parameter you pass to a tool seems to have been ignored, the most likely cause is schema/code drift — the server's handler accepts the field, but the MCP tool registration's Zod schema doesn't declare it, so the field was dropped at the protocol boundary.

This skill teaches Claude how to verify the deployed schema directly.

Jul 2026 consolidation note: the deployed surface was consolidated from 37 tools to 28 — old names were merged, not dropped, and two NEW tools were added: publish_post (post now / schedule to connected channels, linked accounts only) and portfolio (list / switch the active portfolio). customize / set_audio / set_voiceover → apply_session_patch; update_visual → update_slides({action:"set_image"}) (replace) + apply_session_patch({visualEdits:[...]}) (insert/splice); preview_live_prompt → animate_slide({dryRun:true}); generate_frames → add_slide_image (reference params, consistent-frames mode); list_recipes / get_recipe_options → recipes; get_balance / get_topup_url / link → wallet; suggest_image_prompt / suggest_music_prompt → suggest_prompt({kind}); get_price → get_result (pre-confirm price breakdown). If a schema-vs-docs diff shows one of the old names missing from the live catalog, that's the consolidation — not drift.

Where to look

The MCP server publishes its tool catalog via the standard MCP tools/list request. Claude Code already calls this on connect — the tool definitions are available in the client's MCP state.

To inspect what was returned:

1. List the tools Claude Code currently sees:

   /mcp poppify
   

   That shows the names, but not the param shapes.

2. For the param shapes, ask the deployed server directly via JSON-RPC tools/list at the canonical MCP endpoint (https://poppify.ai/api/mcp, POST — the Poppify server is stateless, no initialize handshake needed):

   curl -s https://poppify.ai/api/mcp \
     -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
     | sed -n 's/^data: //p' | jq '.result.tools[] | select(.name=="apply_session_patch") | .inputSchema'