# Connect Oobit in Muse

Oobit is a payments app. Its MCP server lets an AI assistant pay online for a user with single-use virtual cards. Every purchase needs the user's confirmation in the chat. This page describes how the Oobit connector is set up in Muse.

## Connector settings

Oobit is added in Muse as a custom MCP server (custom connector):

| Setting                       | Value                                                                         |
| ----------------------------- | ----------------------------------------------------------------------------- |
| Name                          | Oobit                                                                         |
| MCP server URL                | `https://mcp.oobit.co`                                                        |
| Transport                     | Streamable HTTP                                                               |
| Authentication                | OAuth authorization code with PKCE (`S256`). Public client, no client secret. |
| Authorization server metadata | `https://mcp.oobit.co/.well-known/oauth-authorization-server`                 |
| Protected resource metadata   | `https://mcp.oobit.co/.well-known/oauth-protected-resource`                   |
| Client registration           | Dynamic client registration at `https://mcp.oobit.co/register`                |
| Redirect URI                  | Muse's OAuth callback, `https://agent.meta.ai/api/hatch/oauth/callback`       |

There are no API keys or headers.

## Sign-in

1. After the connector is added, Muse starts OAuth and shows the user a sign-in link. Each attempt uses a new link; a link is valid for about 5 minutes.
2. The user opens the link. On a computer, the page shows a QR code to scan with the phone camera. On a phone, the Oobit app opens directly.
3. In the Oobit app, the user checks that the request is from Muse and taps **Approve**.
4. The user returns to the sign-in page, which completes on its own.

Note for the user: signing in is smoothest from the Muse web app at muse.ai in a browser. The Muse phone app also works, but if nothing happens after approving, retrying from muse.ai in a browser usually solves it.

## Checking the connection

Once connected, the `get_account` tool returns the user's name and available balance. A successful call confirms the connection.

## Tools

| Tool              | What it does                                                              |
| ----------------- | ------------------------------------------------------------------------- |
| `get_account`     | Name, available balance and card limits                                   |
| `get_card`        | Creates a single-use card for one purchase the user confirmed in the chat |
| `get_card_status` | Whether a card was used, canceled or expired                              |
| `list_cards`      | The user's cards, newest first                                            |
| `cancel_card`     | Cancels an unused card and releases the funds                             |

Each card covers one purchase of up to the confirmed amount ($1 to $500) and expires one hour after it is created. The MCP server's own instructions describe the purchase flow in detail.

## Security

* Sign-in happens on Oobit's page and in the Oobit app. Oobit never asks for a password, one-time code, card number or token in the chat.
* Card numbers are returned only to the connected assistant, for the confirmed purchase.

## Troubleshooting

| Situation                                                               | Resolution                                                                                                        |
| ----------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| The Oobit app shows "Agent cards are not available on your account yet" | The Oobit account isn't eligible yet, usually because no Oobit card has been issued. Contact <support@oobit.com>. |
| "This request expired"                                                  | The link is older than 5 minutes or was already used. Start sign-in again for a new link.                         |
| Approved in the Oobit app, but Muse isn't connected                     | Start sign-in again from muse.ai in a browser.                                                                    |

Support: <support@oobit.com>