# Artiji — Agent-Payable Astrology Card Service

Artiji generates personalized astrology cards and horoscopes on demand.
It is designed for agent-to-agent payments: request a card, pay, receive content.

---

## For Agents

- Request natal charts, daily horoscopes, or custom readings via REST
- Pay per-request using Stripe Single-Payment Tokens (SPT) or Tempo (planned)
- Responses are structured JSON; no session or login required
- Rate limiting is per-token, not per-IP

---

## Endpoints

| Method | Canonical URL | Purpose | Payment Required |
|--------|--------------|---------|-----------------|
| GET | `https://lkhihihiezfbhodmioba.supabase.co/functions/v1/agent-catalog` | List available card types, prices, and input schemas | No |
| POST | `https://lkhihihiezfbhodmioba.supabase.co/functions/v1/agent-cards` | Generate a card or horoscope; returns 402 with payment URL if unpaid | Yes |
| GET | `/mcp` | MCP server entrypoint for tool-calling agents | (planned v1.1) |

> **Note:** Pretty `/api/agent/*` paths are planned for v1.1 when CF Workers reverse proxy lands. Use the canonical Supabase function URLs above today.

> `POST /api/agent/cards` currently returns a **402 stub** with a payment intent URL.
> Full payment flow goes live with Stripe SPT integration.

---

## Payment Methods

| Method | Status |
|--------|--------|
| Stripe Single-Payment Tokens (SPT) | Live soon — Stripe SPT launch pending |
| Tempo | Planned |
| Manual / test mode | Available now for dev/staging |

All payment flows are **MPP-compliant** (Model-to-Model Payment Protocol).

---

## Pricing Tiers

| Product | Price Range |
|---------|------------|
| Single astrology card | $0.05 – $1.00 |
| Daily / weekly horoscope | $2.00 – $20.00 |
| Custom horoscope (full natal + interpretation) | ~$50.00 |

Prices are returned in the catalog response and may vary by card type and complexity.

---

## MCP Server

Coming in **v1.1**. Will expose card generation and catalog as MCP tools,
enabling direct tool-calling without raw HTTP.

Entrypoint: `/mcp` (planned v1.1)

---

## Discovery

| Resource | Status |
|----------|--------|
| `llms.txt` | [/llms.txt](/llms.txt) |
| OpenAPI spec | Planned |
| Stripe ACP profile | Planned |

---

## Contact / Repository

- Maintainer: schwentker@sandboxlabs.ai
- Repo: internal (not yet public)