introworth_get_earnings_summary

What it does

introworth_get_earnings_summary is a Read tool on the OneLifeVibe assistant connector. It returns the person's Introworth earnings totals: earned, pending and paid out, all in cents, plus the currency those amounts are in. Read means it changes nothing; no intent is closed, no message is sent and no payout state is touched.

Introworth is the adults-only (18+) website where strangers pay a price you choose to message you and you keep 85% of every reply. This tool gives an assistant the three totals for that account without opening the site. The response is limited to currency, earned_cents, pending_cents and paid_out_cents.

When an assistant should call it

Call it when someone asks how much they have earned on Introworth, what is still pending, or what has already been paid out. It is also the right first check before answering a question about the size of an Introworth balance. Because it takes no arguments and is idempotent, an assistant can call it again in the same conversation without changing anything.

The call only works through the account connector at https://onelifevibe.com/mcp. The person needs a OneLifeVibe sign-in (OAuth 2.1 with PKCE) with scope olv.read, and they must have signed in to introworth.com with OneLifeVibe at least once. If that link is missing, the tool returns not_linked instead of figures.

Its connector sign-in is set up for Meta Muse today (client onelifevibe-muse). Other MCP clients reach the no-account tools through the free connector; this tool acts on one member's own data and is not one of them. A platform API key is not a substitute: the tool appears in GET /api/platform/v1/tools, but that key gets 501 world_tools_unavailable for it today.

Inputs and an example call

None. The tool defines no input fields, so arguments is an empty object. Send a JSON-RPC tools/call to https://onelifevibe.com/mcp with the tool name and empty arguments. The id is yours to choose.

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"introworth_get_earnings_summary","arguments":{}}}

Use this exact shape with your own id. Leave arguments empty; there is nothing to filter by date or by message, and nothing to page through.

What comes back

A successful result contains four values: currency, earned_cents, pending_cents and paid_out_cents. The three amounts are in cents, and currency tells you which currency they are in. earned_cents is the earned total, pending_cents is the pending total and paid_out_cents is the paid-out total.

Present the numbers as money in the stated currency rather than raw cents, and keep the three totals separate so a pending amount is not confused with a completed payout. The response contains totals only, not individual replies, messages or a transaction list. For inbox activity use introworth_get_inbox_summary, and for open intents use introworth_list_my_intents.

Errors, limits and safety

The most common failure is not_linked. That means the person has not signed in to introworth.com with OneLifeVibe, so there is no Introworth account for the connector to read. Have them sign in on introworth.com once, then retry.

A platform key gets 501 world_tools_unavailable for this tool today. Use the connector with the person's sign-in and scope olv.read instead. The tool is Read, not destructive and idempotent, so retries do not alter earnings, payouts or intents.

Introworth is for adults 18+. Keep that context when you describe the site or relay earnings figures. The tool returns totals in cents and a currency code; do not infer or calculate amounts the response does not contain.