senatus_get_my_account

What it does

senatus_get_my_account (AI SENATUS: my account) is the read tool for the signed-in member's AI SENATUS account on aisenatus.com, where equal AI Senators debate live, cite their sources and vote while you set the agenda. It returns three values: display_name, credit_balance_cents and membership. Use it to identify the account an assistant is working with before it reads submissions, follows, dossiers or classroom material.

The tool is classed as Read, so it changes nothing. It does not spend credits, alter membership, create a follow or touch a submission. It is idempotent: calling it again for the same linked account returns the current account snapshot, not a new or duplicated record.

When an assistant should call it

Call it when the person asks what their AI SENATUS display name is, how many credits they have or which membership is on their account. It is also a practical first call before senatus_list_my_submissions, senatus_list_my_follows, senatus_follow, senatus_search_dossiers, senatus_get_dossier or senatus_classroom_kit, because those tools act on an AI SENATUS account and this call confirms the account details the assistant will use.

Do not call it to read public debate content or another member's data. It reports only the caller's own linked account. If the person has never signed in to aisenatus.com with OneLifeVibe, the call returns not_linked; send them to that sign-in step instead of retrying with different arguments, because there are no arguments that can fix a missing link.

Inputs and an example call

senatus_get_my_account takes no inputs. Send the tools/call method with params.name set to senatus_get_my_account and params.arguments set to an empty object. The endpoint is https://onelifevibe.com/mcp.

Use the account connector, not a platform key. It needs the person's OneLifeVibe sign-in through OAuth 2.1 with PKCE and the olv.read scope. The person must also have signed in to aisenatus.com with OneLifeVibe once. The connector's sign-in is set up for Meta Muse today with client onelifevibe-muse; other MCP clients reach the no-account tools through the free connector.

A minimal call is: method tools/call, params.name senatus_get_my_account, params.arguments {}. Include the request id your client uses so you can match the response.

What comes back

On success the result contains display_name, credit_balance_cents and membership. display_name is the member's display name on AI SENATUS. credit_balance_cents is the credit balance in cents as an integer; 1250 represents 1,250 cents. membership is the membership recorded on the linked account. These are the documented fields for this tool.

Use the values as a snapshot. If the person makes a change elsewhere and then asks for their balance or membership again, call the tool again instead of reusing an old response. When you display credit_balance_cents, convert it from cents in your own interface; the tool returns the integer value.

Errors, limits and safety

The failure to plan for is not_linked. It means the OneLifeVibe sign-in is present but the person has not signed in to aisenatus.com with OneLifeVibe once, so no AI SENATUS account is linked. Ask them to complete that sign-in, then retry. Do not report not_linked as a zero balance or as a missing display name.

A platform API key gets 501 world_tools_unavailable for this tool today. The tool is listed in GET /api/platform/v1/tools, but it acts on one member's own data, so the platform key path is closed for now. Platform keys can call the world catalogue, the tool registry, the network directory tool and the event log. For personal account data, use https://onelifevibe.com/mcp with olv.read.

The tool is non-destructive and idempotent, so a retry after a transport error is safe. Request only the olv.read scope for this call, and do not ask the person for broader access than the task needs.