Meta Muse connector
Unspent, by asking
Tell Meta Muse what you didn’t buy and it records it in Unspent. Ask what you have saved, start a no-spend challenge with friends, or catch up on what they have been resisting.
Last updated 7 October 2026 · support@unspent.finance
Connector URL
Give Muse this address when it asks for the connector’s URL.
https://mcp.unspent.finance/mcp
You must be 18 or over and in the United States. The connector cannot move money: Unspent records amounts you chose not to spend, and nothing more.
What it does
Unspent is an app for recording money you decided not to spend — on your own, or in private no-spend challenges with friends. The connector lets Muse do the everyday parts of that for you in conversation:
- record something you resisted, didn’t buy, or a discount you kept, with a category and a note;
- tell you your total and your recent unspents;
- create, join and follow private no-spend challenges with friends, invite people to them, see how everyone is doing, and be proud of a friend’s unspent;
- correct an entry’s date, category or note, or undo an entry;
- join early access for bank connections, link to the app, or delete your account.
Unspent does not move money, and neither does the connector. No tool transfers, holds, invests or withdraws funds, and none connects a bank. Bank connections are not available yet; you can only join the early access list for them.
The connector only answers. It does not message you, remind you or alert you about anything. Muse finds out what has happened in your challenges only when you ask.
Try asking
| You say | Muse uses |
|---|---|
| “I resisted a $6 coffee.” | log_unspent, category Coffee |
| “I got $40 off the jacket and I’m keeping it.” | log_unspent, category Shopping |
| “How much have I not spent so far?” | get_summary |
| “Join my friend’s challenge, the code is K4M9QT.” | preview_invite, then join_challenge |
| “How am I doing in the challenge?” | get_challenge |
| “I’m proud of Maya’s lunch unspent.” | get_challenge_feed, then be_proud |
| “Start a no-spend challenge with friends for October.” | create_challenge, then create_invite |
| “What’s new in my challenge?” | get_challenge_updates |
| “That coffee was yesterday, not today.” | list_entries, then update_entry |
| “Undo the last one.” | reverse_entry, after Muse confirms with you |
Connecting in Muse
- In Muse, ask it to add a custom connector and give it the URL above. Once Unspent is listed in Muse’s connector directory, you will also be able to add it from Settings → Connectors.
- Muse opens Unspent’s connect page. Choose how to continue and what to allow.
- You return to Muse, connected. Ask it something.
The connect page
You choose one of three ways in:
- Continue as guest
- The quickest. Unspent creates a new account that only Muse uses. There is no sign-in and we never learn your email address. You can link it to the app later. The account is reached only through this Muse connection: connecting again without an account creates a new, empty one, so link it to the app if you want to keep it.
- Continue with Apple, or Continue with Google
- Signs you in to the same account the Unspent app uses with that provider, so Muse works on your existing ledger and challenges. If you use Apple in the app, use Apple here too: another provider is a different account.
And what Muse may do:
- Full access
- Read your unspents and challenges, and make changes on your behalf: every tool listed below. This is the default.
- Read only
- Read your unspents and challenges. Muse cannot record, change, undo or delete anything. To allow changes later, disconnect and connect again with full access.
Linking a Muse-only account to the app
If you chose Continue as guest and later want your Muse entries in the Unspent app, link the two. An account created with Apple or Google on the connect page is already the app account and needs no linking.
-
In the Unspent app, signed in, open the menu and choose Meta Muse, then
ask for a link code. It is eight characters, shown in two groups like
K7PQ-4DXM, works once, and expires after 10 minutes. - Tell Muse: “Link my Unspent app account with code K7PQ-4DXM.”
- The app shows the request with what would move: the number of entries, their total and your challenges. A code alone changes nothing; nothing moves until you approve.
- Approve it in the app, or decline it. A request expires after 10 minutes.
When you approve, your Muse entries, reversals and challenges move into the app account unchanged, and Muse keeps working without reconnecting. If both accounts are in the same challenge, you keep one membership with the app account’s display name, goal and notification setting. If either account joined bank connection early access, the app account keeps the earlier date. The Muse-only account is then emptied.
Tools
Every tool is listed to Muse whatever access you chose. A tool that changes something,
called on a read-only connection, fails with insufficient_scope.
- Read
-
Returns data and changes nothing. Scope
unspent.read. AnnotatedreadOnlyHint: true. - Write
-
Records or changes something you asked for, and can be corrected afterwards. Scope
unspent.write. AnnotatedreadOnlyHint: false,destructiveHint: false. - Sensitive write
-
Cancels or deletes something. Muse should confirm with you before calling it. Scope
unspent.write. AnnotateddestructiveHint: true.
All tools set openWorldHint: false: they act only on your Unspent account. Money
is in whole US cents (amountCents). Categories (categoryId) are unlabeled,
coffee, food, shopping, ride,
fun, tech and other. Timestamps are ISO 8601 UTC and
dates are YYYY-MM-DD. An idempotencyKey is a UUID Muse generates
once per action and reuses if it retries, so a retry never records twice.
| Tool | Class | What it does |
|---|---|---|
get_summary | Read | Your totals |
list_entries | Read | Your entries, a page at a time |
list_challenges | Read | Challenges you are in |
get_challenge | Read | One challenge in detail |
get_challenge_feed | Read | A challenge’s entries feed |
get_challenge_updates | Read | Recent activity across your challenges |
preview_invite | Read | What an invite code would join |
log_unspent | Write | Records an amount you didn’t spend |
be_proud | Write | Tells a member you’re proud of their unspent |
update_entry | Write | Corrects an entry’s date, category or note |
create_challenge | Write | Starts a challenge |
join_challenge | Write | Joins a challenge with an invite code |
create_invite | Write | Makes an invite link for a challenge |
update_my_challenge_profile | Write | Changes your display name or mute setting in a challenge |
leave_challenge | Write | Leaves a challenge |
join_waitlist | Write | Joins early access for bank connections |
link_app_account | Write | Asks to link this Muse-only account to the app |
reverse_entry | Sensitive write | Undoes an entry |
delete_account | Sensitive write | Deletes your Unspent account |
Read tools
get_summary-
Inputs: none. Returns:
totalUnspentCents,unspentCount,activeChallengeCountandearlyAccessJoinedAt(null if you haven’t joined bank connection early access). Side effects: none. list_entries-
Inputs:
limit(1–50, default 20),cursorfrom a previous page. Returns:entriesandnextCursor. Each entry hasid,amountCents,categoryId,note,createdAt,reversalOfEntryIdandreversedByEntryId. Side effects: none. list_challenges-
Inputs:
limit(1–50),cursor. Returns: the challenges you are in, as the app lists them, each with its status (upcoming,activeorfinished). Side effects: none. get_challenge-
Inputs:
challengeId. Returns: the challenge as the app shows it: status, dates, members’ display names, totals and goal progress, the group total, and your own membership. Errors:not_foundif you are not in it. Side effects: none. get_challenge_feed-
Inputs:
challengeId,limit,cursor. Returns: the challenge’s entries feed, as the app shows it to members: each entry’sid, who logged it (memberDisplayName, andisYoufor your own), amount, note,prideCountand whether you are proud of it (isProud). Side effects: none. get_challenge_updates-
Inputs:
since, a timestamp (optional; default 7 days ago). Returns: up to 50updates, newest first, each withchallengeId,challengeTitle,type(entry_added,entry_proud— a member is proud of your unspent —goal_reachedormember_joined),memberDisplayName,entryId,amountCents,noteandat. Side effects: none. This is how Muse answers “what’s new?” — it is never pushed to you. preview_invite-
Inputs:
inviteCode(6 characters). Returns: the invitation preview the app shows before joining. Errors:not_foundfor an unknown code. Side effects: none.
Write tools
log_unspent-
Inputs:
amountCents,idempotencyKey; optionalcategoryId(defaultunlabeled) andnote. Returns: the saved entry andcountedTowardChallenges, the challenges it counts toward; the same key returns the same entry rather than a second one. Side effects: adds an entry to your ledger, with the same effect on any challenge you are in as saving it in the app. be_proud-
Inputs:
challengeId,entryId(fromget_challenge_feed); optionalproud(default true; false takes it back). Returns:entryId,prideCount,isProud. Side effects: the member who logged it sees that you are proud of it, and the app notifies them once. Errors:conflictfor your own unspent,not_foundif it isn’t in the challenge. update_entry-
Inputs:
entryId; optionalcategoryId,noteandoccurredAt(not in the future). Omitted fields keep their values. Returns: the updated entry. Side effects: changes only the description and date. The amount can never be edited; to change it, undo the entry and record a new one. create_challenge-
Inputs:
title,displayName,timeZone(IANA, such asAmerica/New_York),startDate,endDate,idempotencyKey; optionalgoalCents. Returns: the challenge detail. Side effects: creates a private challenge with you as its first member, under the display name you gave. join_challenge-
Inputs:
inviteCode,displayName. Returns: the challenge detail. Side effects: makes you a member. Members see your display name, your challenge total and progress, and the descriptions and amounts of entries linked to the challenge after you join. Errors:conflictif the challenge has ended or is full. create_invite-
Inputs:
challengeId,idempotencyKey. Returns:inviteUrl(https://unspent.finance/challenge/<code>),inviteCode,expiresAt. Side effects: creates an invitation. Anyone holding a live link or code can preview the challenge and join it, so share it only with the people you mean to invite. update_my_challenge_profile-
Inputs:
challengeId; optionaldisplayNameandmuteNotifications. Returns: your membership. Side effects: changes how you appear to members, or whether the app notifies you about this challenge. leave_challenge-
Inputs:
challengeId. Returns:left: true. Side effects: new entries stop being linked to the challenge; entries already linked stay in its feed. You can rejoin with a valid invite while the challenge is running. join_waitlist-
Inputs: none. Returns:
earlyAccessJoinedAt. Side effects: records that you want early access to bank connections, as joining from the app’s menu does; joining again keeps the first date. It connects nothing and moves no money. link_app_account-
Inputs:
code, the link code shown in the app. Returns:status: "pending_approval"andexpiresAt. Side effects: none until you approve the request in the app; see linking above. Errors:link_code_invalid,already_linked.
Sensitive write tools
reverse_entry-
Inputs:
entryId. Returns: the reversal entry. Side effects: writes an opposite entry that cancels the original, exactly as Undo does in the app. The original stays in your history, marked reversed. Errors:conflictif it is already reversed. delete_account-
Inputs: none. Returns:
deleted: true. Side effects: permanently deletes your Unspent account — the same as deleting it in the app — including entries from the app if the account is shared with it. The connection stops working. This cannot be undone.
Errors
A failed tool call returns isError: true, a message, and a code Muse can act
on:
| Code | Meaning |
|---|---|
invalid_arguments | A field is missing or invalid; the message names it. |
insufficient_scope | The connection is read-only. Reconnect with full access. |
not_found | No such entry, challenge or invite for this account. |
conflict | The request conflicts with the current state: already reversed, challenge ended, challenge full. |
link_code_invalid | The app link code is wrong, used or expired. |
already_linked | This Muse account is already an app account. |
rate_limited | Too many calls; retry after a minute. |
unavailable | A temporary problem on our side; retry later. |
A missing, expired or revoked token gets HTTP 401 with a
WWW-Authenticate header pointing at the protected-resource metadata, and Muse
refreshes or reconnects.
Rate limits
- 120 tool calls a minute for each connection.
- 50 requests a second to the connector across all users, with bursts to 100.
- Account creation on the connect page: 2 a second, with bursts to 5.
Data and retention
The connector reads and writes only your own Unspent account, and only when you ask Muse to do something. What Muse receives is what the tool returns: your settings, totals, entries and the challenges you are in, including what other members share with you there. Unspent never sends Muse your email address. The full detail is in the privacy policy.
- Tokens are stored only as one-way digests. Access tokens last an hour and refresh tokens 60 days, replaced on every use. Tokens never appear in tool responses and we do not log them. Your Apple or Google password never reaches us.
- We don’t sell your data, use it for advertising, or use it to train AI models, and the connector does not share it with anyone but the Muse you connected.
- We measure which features are used, not what’s in them. Mixpanel receives events such as which sign-in option you chose and which tool Muse called, and whether it worked. Never amounts, notes, challenge content or what you said to Muse.
- Muse-only accounts that go 12 months without a tool call or sign-in are deleted automatically. Accounts the app also uses are kept while they exist.
- What Meta does with your conversation is governed by Meta’s own terms and privacy policy.
Disconnecting and deleting
- Disconnect Unspent in Muse’s connector settings. If your account is also in the app, you can see and revoke Muse connections there too, under the menu’s Meta Muse screen. Disconnecting does not delete your account or your entries. A Muse-only account cannot be reconnected once its connection is gone; link it to the app first, or delete it, or it is deleted after 12 months without use.
- Delete your account by asking Muse to delete your Unspent account, or from the app’s menu. Deletion is permanent and covers everything the account holds, whichever way it was recorded.
- You can also write to privacy@unspent.finance for a copy of your data or to have it deleted.
For developers and reviewers
| MCP endpoint | https://mcp.unspent.finance/mcp — Streamable HTTP, stateless, JSON responses |
|---|---|
| Protocol versions | 2025-11-25, 2025-06-18, 2025-03-26 |
| Authorization server | https://mcp.unspent.finance — OAuth 2.1, public clients, PKCE S256 |
| Resource metadata | https://mcp.unspent.finance/.well-known/oauth-protected-resource/mcp |
| Server metadata | https://mcp.unspent.finance/.well-known/oauth-authorization-server |
| Client registration | Dynamic registration at /oauth/register, or a client ID metadata document |
| Scopes | unspent.read (read tools); unspent.write (write and sensitive-write tools, implies read) |
| Revocation | https://mcp.unspent.finance/oauth/revoke |
Support and security
Unspent is made by Meanwhile Agency LLC, 44 Montgomery Street, San Francisco, CA 94104, United States.
- Help with the connector or the app: support@unspent.finance
- Your data and privacy choices: privacy@unspent.finance
- Reporting a vulnerability: security@unspent.finance
Using the connector is covered by our terms of use and privacy policy.