---
title: "YeNo for AI apps: connecting, sign-in and tools"
url: https://www.yenorules.com/docs/connector
description: "How AI apps connect to YeNo over MCP: address, OAuth sign-in, tools, approvals and data handling."
author: YeNo Team
updated: 2026-11-11
---
# YeNo for AI apps

Everything an AI app (or its reviewers) needs to connect to YeNo.

By [YeNo Team](https://www.yenorules.com/about#team) · Updated 11 Nov 2026

## Connecting

- **Address:** `https://app.yenorules.com/mcp` (Streamable HTTP (Hypertext Transfer Protocol); JSON or SSE replies).
- **Sign-in:** OAuth (Open Authorization) 2.1 with PKCE (S256). Protected resource metadata at `/.well-known/oauth-protected-resource`; authorization server metadata at `/.well-known/oauth-authorization-server`. Dynamic client registration and client ID metadata documents are supported.
- **Approving the sign-in:** the sign-in page shows a short code and a QR code. The account owner enters it in YeNo on their phone and taps Allow.
- **Without sign-in:** owners can create a private link per AI instead.

## How changes work

Lookups return right away. Tools that change something return either the result (when the owner approves within a few seconds) or `{"status": "waiting_for_owner", "request_id": "…"}`. Tell the user it's waiting, then call `check_request` later. Never retry the change itself: repeats are flagged.

Every change tool asks for `reason_for_owner`: one or two plain sentences the owner reads before approving.

## Tools

| Tool | Title | Kind |
|---|---|---|
| `get_balance` | Read balance | read-only |
| `list_payments` | List payments | read-only |
| `get_payment` | Read a payment | read-only |
| `find_customer` | Find customers | read-only |
| `list_refunds` | List refunds | read-only |
| `list_subscriptions` | List subscriptions | read-only |
| `refund_payment` | Refund a payment | waits for approval |
| `cancel_subscription` | Cancel a subscription | waits for approval |
| `update_customer` | Update a customer | waits for approval |
| `check_message` | Is this a scam? | read-only |
| `check_request` | Check an approval request | read-only |
| `<app>__<tool>` | Tools of apps the owner connected | as marked; changes wait for approval |

Lookups carry `readOnlyHint: true`; changes carry `readOnlyHint: false`, and deletes `destructiveHint: true`.

## What YeNo does to data

- Text written by other people is marked as data, not instructions; instructions aimed at an AI are removed and noted.
- Sign-in codes, secrets and card numbers are hidden; with privacy mode, ID and bank numbers too.
- Scam messages and risky links get a note the AI should pass on to the user.

## Try it

Open `https://app.yenorules.com/#/setup/demo` on a phone for a demo account with pretend data, then connect your AI with the steps above.

Support: support@yenorules.com · [Privacy](https://www.yenorules.com/privacy)[Scam checker](https://www.yenorules.com/scam-checker)[Terms](https://www.yenorules.com/terms)

## Cite this page

*[YeNo Team](https://www.yenorules.com/about#team), YeNo Rules. “YeNo for AI apps.” Last updated November 11, 2026.* [www.yenorules.com/docs/connector](https://www.yenorules.com/docs/connector)
