> For the complete documentation index, see [llms.txt](https://docs.hostinger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hostinger.com/agent-skills/troubleshooting.md).

# Troubleshooting & FAQ

Fix common problems with Hostinger agent skills, such as the agent not using a skill or not reaching your Hostinger account, choose the right skill for a task, and report a problem.

## The agent doesn't use the skill

1. **Check that it's installed.** See [Check that skills are installed](https://docs.hostinger.com/agent-skills/install.md#check-that-skills-are-installed) for each agent.
2. **Restart the agent**, or in Claude Code run `/reload-plugins`. Most agents load skills when a session starts.
3. **Invoke it by name**, for example `/hostinger:troubleshoot-website` in Claude Code, `$troubleshoot-website` in Codex, or *"Use the troubleshoot-website skill"* in any agent.
4. **Check where it was installed.** The skills CLI installs into the current project unless you pass `-g`. A skill installed in one project isn't available in another.
5. **Describe the task, not the tool.** Agents pick skills by matching your request to the skill's description. *"My site shows a 502 error"* matches better than *"run diagnostics"*.

## The agent can't access my account

The [web hosting skills](https://docs.hostinger.com/agent-skills/web-hosting-skills.md) need the Hostinger MCP server connected to your account. The skill alone doesn't give the agent access.

* Connect with [Hostinger Connector](https://docs.hostinger.com/hostinger-connector/installation-and-setup.md), a [plugin](https://docs.hostinger.com/agent-skills/install.md), or [manual configuration](https://docs.hostinger.com/hostinger-connector/manual-configuration.md).
* After connecting, fully restart editors such as Cursor so they pick up the new configuration.
* If the skill says an operation can't be found, the product group it needs is switched off. Enable it in the Hostinger Connector sidebar, for example **Websites** for `maintain-wordpress` or **Domains** for `connect-domain`. See [Using the Connector](https://docs.hostinger.com/hostinger-connector/using-the-connector.md).
* For connection problems, see [Troubleshooting Hostinger Connector](https://docs.hostinger.com/hostinger-connector/troubleshooting.md).

The [API reference skills](https://docs.hostinger.com/agent-skills/api-reference-skills.md) don't use the MCP server. They need an API token in the `HOSTINGER_API_TOKEN` environment variable, set before you start the agent. See [Requirements](https://docs.hostinger.com/agent-skills/api-reference-skills.md#requirements).

## Which skill should I use?

| I want to…                                                            | Skill                                                                                                           |
| --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| Put an existing project online, or redeploy it                        | [deploy-to-hosting](https://docs.hostinger.com/agent-skills/web-hosting-skills.md#deploy-to-hosting)            |
| Build a new website from a description                                | [hostinger-headless](https://docs.hostinger.com/agent-skills/web-hosting-skills.md#hostinger-headless)          |
| Use my own domain, add a subdomain or fix a domain that isn't working | [connect-domain](https://docs.hostinger.com/agent-skills/web-hosting-skills.md#connect-domain)                  |
| Fix a site that is down, slow, insecure or failing to build           | [troubleshoot-website](https://docs.hostinger.com/agent-skills/web-hosting-skills.md#troubleshoot-website)      |
| Move a site from another host                                         | [migrate-to-hosting](https://docs.hostinger.com/agent-skills/web-hosting-skills.md#migrate-to-hosting)          |
| Update WordPress and check it for vulnerabilities                     | [maintain-wordpress](https://docs.hostinger.com/agent-skills/web-hosting-skills.md#maintain-wordpress)          |
| See what I have and what needs attention                              | [audit-hosting](https://docs.hostinger.com/agent-skills/web-hosting-skills.md#audit-hosting)                    |
| Write a script or integration against the Hostinger API               | An [API reference skill](https://docs.hostinger.com/agent-skills/api-reference-skills.md) for that product area |

Not sure where to start? Ask for an audit. [audit-hosting](https://docs.hostinger.com/agent-skills/web-hosting-skills.md#audit-hosting) only reads, and names the skill that fixes each item it finds.

## Do I need both skill sets?

No. Install the web hosting skills to have the agent work on your websites through the MCP server. Install the API reference skills if you write code that calls the Hostinger API. You can install both: their names don't overlap.

## Report a problem

Open an issue on the repository the skill comes from:

* Web hosting skills: [hostinger/api-mcp-server issues](https://github.com/hostinger/api-mcp-server/issues)
* API reference skills: [hostinger/hostinger-agent-skills issues](https://github.com/hostinger/hostinger-agent-skills/issues)

Include the skill name, your agent and its version, how you installed the skill, and what the agent did. Remove API tokens, passwords and other secrets before you paste logs or configuration files.

***

*Last updated: November 15, 2026*
