# Rill Agent Plugin

Portable [Agent Plugins 1.0](https://agent-plugins.org) package: **Agent Skill** + **hosted MCP** for Spend / Accept / Network payments.

- **MCP:** `https://mcp.userill.com/mcp`
- **Guest:** `https://mcp.userill.com/mcp/guest`
- **Docs:** [userill.com/docs/mcp/overview](https://userill.com/docs/mcp/overview)
- **Briefing:** [userill.com/llms.txt](https://userill.com/llms.txt)

## What it does

Connects agent clients to Rill so they can register or claim a handle, fund a wallet, mint `rill_vw_*`, pay any MPP/x402 URL with `rill_pay_url` (primary Spend), verify receipts, and create hosted pay links, see `skills/rill-spend-pay/SKILL.md`.

## Install

### Cursor

Load this directory as a plugin, or MCP-only:

```json
{
  "mcpServers": {
    "rill": {
      "url": "https://mcp.userill.com/mcp"
    }
  }
}
```

### Codex

```bash
# local (monorepo submodule) or public GitHub
codex plugin marketplace add /path/to/apps/agent-plugin
# or: codex plugin marketplace add rillongit/agent-plugin

codex plugin add rill@rill
```

## Monorepo

This directory is the public submodule [`rillongit/agent-plugin`](https://github.com/rillongit/agent-plugin) at `apps/agent-plugin`.

Validate manifests locally:

```bash
pnpm plugin:validate
```

## License

MIT — see [LICENSE](./LICENSE).