AI chat (Snapital)
The ai_chat tool generates persona-driven conversation turns through the Snapital AI engine — the same conversion engine used in production. The MCP is a thin, read-only pass-through: it forwards your request and relays the engine's reply. It adds no latency, stores no conversation, and does not price or meter chat.
Two independent meters
| What | How it's billed |
|---|---|
| Knowledge-base access | Your $150/mo SNAPFANS MCP subscription |
| AI chat usage | Per conversation, on your own Snapital account |
Chat is bring-your-own-key: you supply your Snapital AI key on each ai_chat call. All chat authentication, pricing, per-conversation billing, and credits live in your Snapital account — the MCP never sees a rate. Check your balance any time with get_chat_balance.
Request
Arguments mirror the Snapital engine turn contract. An empty chat_history auto-triggers an opener; a last message from the bot triggers a follow-up; otherwise it's a reply.
{
"snapital_key": "<your Snapital AI key>",
"model_id": 43,
"preset_id": 88,
"account_id": "acct1",
"user_infos": { "useridentifier": "u1", "name": "Jake" },
"chat_history": [
{ "role": "bot", "content": "heyy", "timestamp": 1730755200 },
{ "role": "user", "content": "hey whats up", "timestamp": 1730755260 }
]
}Response
An ordered content array (text / image / video / audio) plus conversation state.
{
"content": [
{ "type": "text", "content": "hey! how's your day going 😄" },
{ "type": "image", "content": "https://.../selfie.jpg", "mediaPool": "Primary" }
],
"converted": false,
"conversationId": 1,
"statistics": { "currentPhase": "Building Rapport", "totalExchanges": 3, "…": "…" }
}Relayed signals
The tool surfaces the engine's own verdicts rather than computing anything:
| Signal | Meaning |
|---|---|
insufficient_credits | Your Snapital SnapCredits are exhausted — top up your Snapital wallet. |
snapital_auth_failed | Invalid or unauthorized Snapital AI key. |
rate_limited | Snapital gateway fair-use limit; retry shortly. |
snapital_unavailable | The Snapital service is temporarily unreachable. |
Don't have a Snapital key yet? The documentation tools work without one — AI chat is an optional add-on. See Pricing & coverage.