Troubleshooting

"Invalid token" error

• Make sure you copied the entire token (starts with odd_live_)
• Check if your token has expired (30-day expiry)
• Regenerate a new token from your settings page

"Rate limit exceeded" error

• You've exceeded 100 requests for today
• Wait until midnight UTC for the limit to reset
• Check the X-RateLimit-Reset header for the exact reset time
• See Rate Limits for details on plans and limits

MCP server not appearing in Claude Desktop

• Make sure Node.js 18+ is installed
• Verify the JSON syntax in your config file is valid
• Ensure your API token is set in the configuration (see Claude Desktop Setup)
• Completely restart Claude Desktop (not just close the window)
• Check the Claude Desktop logs for error messages

MCP server not appearing in Cursor

• Ensure your .cursor/mcp.json file is in the correct location
• Verify the url field points to https://opendatadictionary.com/api/v1/mcp
• Check that your API token is included in the Authorization header
• Restart Cursor completely after config changes
• See Cursor IDE Setup for the full configuration

"Word not found" responses

• The word must exist in the dictionary and be approved
• Try using search_words with a partial match first
• Check for typos in the word name

Connection timeout

• Verify your internet connection is active
• Check if opendatadictionary.com is reachable from your network
• Corporate firewalls or VPNs may block outbound connections — check with your IT team
• Try again in a few minutes; the server may be temporarily unavailable

Invalid JSON in config file

• Use a JSON validator to check your configuration file syntax
• Common mistakes: trailing commas, missing quotes around keys, unescaped characters
• Ensure environment variables like YOUR_API_TOKEN are replaced with your actual token value

---