Overview
Perfect for entertainment apps, daily fortune features, party games, and adding personalized mystical elements to applications with AI-driven content.
Live Test AI Fortune Teller Skill Skill →
The tool
Once your client is connected to the VerveKit server, this appears in its tool list as AIFortuneTellerSkill. It is read-only and open-world — it fetches and never mutates anything on your side — so most clients call it without asking you to confirm.
{
"name": "AIFortuneTellerSkill",
"arguments": {}
}Connecting
One server URL covers every skill in the catalog, including this one. Authorization is OAuth: the client opens a browser once, and there is no key to paste into a config file.
{
"mcpServers": {
"vervekit": {
"url": "https://api.vervekit.com/v1/mcp"
}
}
}https://api.vervekit.com/v1/mcpPer-client setup — Claude, Cursor, VS Code, ChatGPT — is on the MCP setup page.
Arguments
These are the properties on the tool's inputSchema, so a well-behaved client validates them before the call is made. Premium arguments are accepted on every plan but only take effect on plans that include them.
| Argument | Type | Description |
|---|---|---|
categoryOptional | string | Fortune categorygenerallovecareerhealthwealthtraveldefault general |
questionOptional | string | Optional question for personalized fortune (max 500 characters) length 0–500 |
What the model gets back
The result carries a structuredContent object matching the tool's declared outputSchema, so a client reads fields without parsing prose. status is "ok" and error is null on success; a null field means the value was not available for that input, not that the call failed.
{
"status": "ok",
"error": null,
"data": {
"fortune": "The threads of destiny are weaving a tapestry of unexpected joy; embrace the unknown, for within its depths lie blossoms of serendipity. A golden opportunity awaits, carried upon the wings of synchronicity.",
"insight": "Trust in the whispers of your intuition; it shall guide you through the maze of life.",
"timeframe": "in the coming weeks",
"category": "general",
"question": null,
"luckyNumbers": [
87,
10,
16,
83,
99,
34
],
"luckyElement": "Wood",
"luckyColor": "Purple",
"luckyDay": "Tuesday",
"timestamp": "2025-12-16T22:23:31.796Z"
}
}
Response fields
Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.
| Field | Type | Example | Description |
|---|---|---|---|
fortune | string | The threads of destiny are weaving a tapestry of unexpected joy; embrace the unknown, for within its depths lie blossoms of serendipity. A golden opportunity awaits, carried upon the wings of synchronicity. | Main AI-generated fortune prediction text message |
insightPremium | string | Trust in the whispers of your intuition; it shall guide you through the maze of life. | Intuitive guidance and wisdom derived from fortune |
timeframePremium | string | in the coming weeks | Timeframe indicating when the fortune will manifest |
category | string | general | Category of the fortune requested by user |
question | object | null | User's original question if provided in request |
luckyNumbersPremium | array | [87,10,16] | Array of AI-selected lucky numbers for fortune |
luckyElementPremium | string | Wood | Lucky elemental association from mystical traditions |
luckyColorPremium | string | Purple | Lucky color associated with the fortune |
luckyDayPremium | string | Tuesday | Lucky day of week for fortune manifestation |
timestamp | string | 2025-12-16T22:23:31.796Z | ISO timestamp of when fortune was generated |
Failure modes
Errors come back as tool errors carrying a sentence the model can act on, not a bare status code. Error handling covers the full list.
| Status | What it means |
|---|---|
400 / 422 | The arguments did not validate. The message names the offending one. |
401 | The OAuth session is invalid or expired — reconnect the server. |
403 | Blocked by a key restriction or an IP allow-list. Never a bad identity. |
404 | This skill is not part of VerveKit. Check the catalog. |
429 | Out of credits, or a brief rate limit. The message tells them apart. |
A call costs 10 credits each time the tool actually runs; a model that reasons about the tool without calling it costs nothing.
Use cases
- Daily Fortunes
- Provide users with personalized AI-generated daily fortunes and predictions
- Entertainment Features
- Add AI-powered fortune-telling features to gaming and entertainment platforms
- Question Answering
- Generate mystical responses to user questions about their future
- Inspiration Apps
- Offer AI-generated motivational and inspirational messages through fortune format
Other ways to use AI Fortune Teller Skill
Set up AI Fortune Teller Skill on VerveKit, or reach the same source a different way. Your VerveKit account and credits work on all of them — one key, one balance.
Related
More in Entertainment: