Troubleshooting

These scenarios come up on almost every real project.

Scenario: outdated SDK version🔗

Your project was scaffolded months ago and still points to an older version of the Visual Embed SDK. You ask for a feature that exists only in a newer release, and the generated code does not run.

Fix: Name the version explicitly and ask what changed.

"Update my Liveboard embed code to the latest Visual Embed SDK version and list any
breaking changes from my current version in the documentation."

Scenario: vague follow-up gets a vague answer🔗

"Make the Liveboard better" will not produce useful code. Keep prompts scoped to one outcome.

Approach Prompt

Approach	Prompt
Avoid	`"Can you customize the embed?"`
Use instead	`"Fetch the documentation for LiveboardEmbed and summarize the available customization options."` Then pick one option and ask for it by name.

Avoid

"Can you customize the embed?"

Use instead

"Fetch the documentation for LiveboardEmbed and summarize the available customization options."
Then pick one option and ask for it by name.

General troubleshooting checklist🔗

Symptom	Action
No response or page not loading	Confirm SpotterCode is enabled for this project and the MCP server is reachable.
Slow responses	Break the request into smaller, sequential prompts instead of one large request.
The response looks wrong	Check which tool the agent called. Refine the prompt for specificity before assuming the tool is broken.
The agent infers SpotStay business logic incorrectly	You must specify anything that is not in the documentation or the SDK. Do not ask SpotterCode to infer SpotStay-specific business logic.

Symptom

Action

No response or page not loading

Confirm SpotterCode is enabled for this project and the MCP server is reachable.

Slow responses

Break the request into smaller, sequential prompts instead of one large request.

The response looks wrong

Check which tool the agent called. Refine the prompt for specificity before assuming the tool is broken.

The agent infers SpotStay business logic incorrectly

You must specify anything that is not in the documentation or the SDK. Do not ask SpotterCode to infer SpotStay-specific business logic.

← Previous Next →