Magic 8 Ball
The Magic 8 Ball API brings the time-honored tradition of shaking a plastic sphere to the digital age. Ask any yes-or-no question and receive a definitive answer from our proprietary blue-liquid algorithm. Features configurable cynicism levels for the modern professional and a corporate mode for when you need to justify decisions in a board meeting.
Add to Your MCP Client
Drop this server into Claude Desktop, Cursor, Continue, or any MCP-compatible client.
{
"mcpServers": {
"magic-8-ball": {
"url": "https://api.stupidmcps.com/magic-8-ball/mcp"
}
}
}
{
"mcpServers": {
"magic-8-ball": {
"url": "https://api.stupidmcps.com/magic-8-ball/mcp"
}
}
}
POST https://api.stupidmcps.com/magic-8-ball/mcp
Add the snippet to your client's MCP config (typically claude_desktop_config.json for Claude Desktop, ~/.cursor/mcp.json for Cursor). Restart the client. The tools become available to your AI assistant.
No-code option: connect via Pipeworx — one click into Claude, ChatGPT, and friends.
Or Try It Directly — No MCP Client Required
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
question |
string |
Required | — | Your burning question. We recommend keeping it to yes/no format, but we won't stop you from asking open-ended existential queries. |
cynical |
boolean |
Optional | false |
Enable cynical mode. Answers skew negative because life is like that sometimes. |
corporate |
boolean |
Optional | false |
Rephrase answers in corporate-speak. Useful for quarterly reviews and strategy meetings. |
Examples
curl "https://api.stupidapis.com/magic-8-ball/ask?question=Should+I+learn+Rust"
import requests
response = requests.get(
"https://api.stupidapis.com/magic-8-ball/ask",
params={"question": "Should I learn Rust"}
)
print(response.json())
const response = await fetch( "https://api.stupidapis.com/magic-8-ball/ask?question=Should+I+learn+Rust" ); const data = await response.json(); console.log(data);
Response Schema
| Field | Type | Description |
|---|---|---|
question |
string |
Your original question, echoed back for posterity |
answer |
string |
The 8 Ball's definitive response |
confidence |
number |
How confident the ball is (0-1). Unrelated to accuracy. |
shake_count |
number |
Number of shakes performed. More shakes = more accurate (not really). |
Example Response
{
"question": "Should I learn Rust?",
"answer": "Reply hazy, try again",
"confidence": 0.42,
"shake_count": 3
}
MCP Access
This API is available as an MCP tool for AI assistants. Connect your agent to:
POST https://api.stupidmcps.com/magic-8-ball/mcp
POST https://api.stupidmcps.com/mcp
Use Pipeworx to connect this MCP tool to Claude, ChatGPT, and other AI assistants with no code.
