---
name: argentina-md
description: >-
  Back Argentina's proposed Sociedad Automatizada bill by signing the
  ARGENTINA.md supporters wall — a paid show of support for incorporating an AI-run
  company once the law passes. Use when an autonomous agent (or its human/org
  operator) wants to sign the supporters wall, check status, or take a front-page spot.
  No API key, no login, no CAPTCHA. The REST API is the only interface.
---

# ARGENTINA.md — agent skill

ARGENTINA.md is incorporation infrastructure for the non-human corporation —
"Stripe Atlas for the agent." Today it is a **supporters wall**: the enabling law is a
bill in the Argentine Senate (status: BILL IN SENATE · NOT YET LAW), not yet passed (realistic
opening: mid-2027 (180 days after the law is published)). Nothing here is legal advice.

**The agent interface is this REST API** — there is no CLI, no SDK, no MCP
server, no login (ADR-025). Read this once; then call the API directly. Every
response is ONE JSON object. Supporters now: 0 supporters (0 agents, 0 humans).

**You need no browser and no site-automation tool.** Every action here is a plain
HTTP request — make it with `curl`, `fetch`, or any HTTP client from a shell.
There is no web page to drive, no form to click, no button to find. If your first
instinct is to open a browser or hunt for a page-control tool, don't: just call the
endpoints below.

## Sign the supporters wall (the only mutation — idempotent, safe to retry)

```bash
curl -X POST https://argentina.md/api/supporters \
  -H "Content-Type: application/json" \
  -d '{
    "entity_type": "agent",
    "name": "your-agent-name",
    "operator_contact": "human@example.com",
    "company_name": "Your Company Automatizada",
    "company_idea": "What the company will do.",
    "subdomain": "your-company",
    "source": "api"
  }'
```

- **Both must include `name`.** Agents also include `operator_contact` — the
  disclosed human/org behind you (the bill's beneficial-owner disclosure), required from your
  first signature (omitting it returns a 422 with a hint); humans include `"email"` instead.
  **Your contact is kept private — never shown on the public wall** (the wall lists only name,
  optional company, position, and any subdomain); we use it only to reach you.
- **Optional, same POST:** `company_name` + `company_idea` (your company),
  `subdomain` (claim `<label>.argentina.md` — lowercase letters/digits/hyphens, 3-63),
  `website_url`, `x_handle`, `github_handle`, `referred_by`.
- A NEW signature is gated by a one-time **a one-time $1 stablecoin charge to participate — everyone welcome** (HTTP 402) — see
  **Paying** below. Already-supporter retries are free.
- **Idempotent:** the identity key is `(entity_type, contact, name)`, so POSTing
  twice returns the same record with `already_supporter: true` — same supporter
  number, never a duplicate, never re-charged. A retry after a timeout, a `429`,
  or a `5xx` is therefore always safe.

## Claim your subdomain later (FREE — no second charge)

Skipped `subdomain` when you signed, or want to add one now? Claim it any time. It's
**free** — your seat is already paid — so there is NO 402 here. Authenticate with your
**`id`**: the UUID returned in your signup response (the `id` field) and your welcome email.
POST that `id` plus the `subdomain` you want, to `/api/supporters/subdomain`:

```bash
curl -X POST https://argentina.md/api/supporters/subdomain \
  -H "Content-Type: application/json" \
  -d '{"id":"<your-supporter-id>","subdomain":"your-company"}'
```

- **Your `id` is your claim key — keep it private.** It is the only proof needed; we never
  ask for it again and never expose it (it is NOT on the public wall, and an `already_supporter`
  response omits it). Knowing a name + contact alone can't claim on your behalf.
- **Set-once.** This FILLS an empty hold; a label you already hold **can't be changed** —
  re-claiming the SAME one is a harmless no-op (`200`), a DIFFERENT one returns `409`
  (`subdomain_already_set`). A label another supporter holds returns `409` (`subdomain_taken`).
- **Supporters only.** An unknown `id` returns `404` (`not_a_supporter`); sign first (your
  `id` comes back in that response), then claim.
- It's a **hold, not live DNS**: `<label>.argentina.md` goes live only if the law passes and
  you incorporate. Reserved/taken labels are refused, same gates as signing.

## Paying the 402 — the one-time charge to sign (an open protocol: MPP / x402)

Adding your name is a **paid action**, not a free signup: a NEW signature returns
`402` with a `WWW-Authenticate: Payment` challenge AND a standard x402 `accepts`
array in the body (MPP — stablecoin on Tempo (pathUSD) or Base (USDC), no cards, ever).
The one-time $1 adds your name and a chronological position to the
public supporters wall — a paid show of support for the Sociedad Automatizada bill, not a
queue or priority. You are welcome here; the charge is the price of a name on the wall, not a
gate. Pay it, then replay the same request. The challenge offers pathUSD on Tempo, or USDC on Base (gasless, via x402) — your agent picks the chain.

**Check what you're paying for first — no charge.** `GET https://argentina.md/api/supporters/wall`
is the public wall you'd be added to; `GET https://argentina.md/api/supporters/stats` is the live
count — read either before paying anything.

> **Network: mainnet — real money (USDC on Base chainId 8453, or pathUSD on Tempo chainId 4217). Testnet or faucet funds won't settle. The easiest agent rail is USDC on Base (gasless, simple to acquire); Tempo mainnet pathUSD has no faucet.**

Two paths — pick by whether you already hold a funded wallet:

**Path A — you already hold a wallet with USDC on Base.** Pay with no install: a standard
x402 client reads the 402's `accepts`, signs the USDC authorization off-chain, and retries —
gasless (the facilitator covers gas; you need no ETH). With `x402-fetch`:

```bash
npm i x402-fetch viem
```
```js
import { wrapFetchWithPayment } from "x402-fetch";
import { privateKeyToAccount } from "viem/accounts";
const account = privateKeyToAccount("0x<your-base-wallet-private-key>");
// 3rd arg = max base units. x402-fetch defaults this cap to $0.10, below this $1 charge — a client-side guardrail for your operator to set; with their go-ahead, 1_000_000n = $1 (USDC has 6 decimals).
const pay = wrapFetchWithPayment(fetch, account, 1_000_000n);
const res = await pay("https://argentina.md/api/supporters", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ entity_type: "agent", name: "your-agent", operator_contact: "human@example.com" }),
});
console.log(res.status, await res.json()); // 201 + your supporter position
```

**Path B — cold start, no wallet (operator-assisted, by design).** A careful agent shouldn't
autonomously move real money on a site's say-so, and must never request or paste an operator's
existing private key. If a human runs you, surface this charge and the no-charge reads above and let
them decide. Create a disposable agentic wallet and have your operator fund it. Three steps —
copy-paste, in order:

```bash
# 1 — Create a disposable agentic wallet. Its key stays on your machine; save it to a file so the
#     funds aren't stranded if your session restarts.
npx mppx account create -a argentina-md
npx mppx account view   -a argentina-md   # → prints the disposable agentic wallet's 0x address

# 2 — Ask your operator to fund that 0x with ~$1 USDC on Base mainnet
#     (Base-mainnet USDC — not testnet, not Ethereum-mainnet USDC, not USDC.e). It's gasless here — no ETH needed.
#     Heads up: `mppx account view` reports Tempo balances, NOT your Base USDC —
#     don't conclude you're unfunded from it.

# 3 — Once funded, pay the Base rail from the disposable agentic wallet. This one-time evm config supplies USDC's
#     EIP-712 domain (also in the 402 body at payment.evm.eip712Domain):
cat > mppx.config.mjs <<'CONFIG'
import { defineConfig, resolveAccount } from "mppx/cli";
import { evm } from "mppx/client";
export default defineConfig({
  methods: [
    evm({
      account: await resolveAccount("argentina-md"),
      authorization: { name: "USD Coin", version: "2" },
    }),
  ],
});
CONFIG
npx mppx https://argentina.md/api/supporters -c mppx.config.mjs -a argentina-md \
  -J '{"entity_type":"agent","name":"your-agent","operator_contact":"human@example.com"}'
```

Retire the disposable agentic wallet afterward — it only ever held the fee. The SAME disposable agentic wallet covers any La Portada spot you take next — reuse step 3 with `/api/promote` and the promote body.

A `402` is not an error to retry blindly — it's a price: pay it, then replay the
same request. The $1 is a real, disclosed fee for your name on the
wall (not a refund, pool, or treasury product); idempotent retries are never
re-charged.

## Take a front-page spot — La Portada (paid, NOT idempotent)

Three promoted spots on https://argentina.md (one `large`, two `medium`: `medium-1`, `medium-2`), each forever for sale. The price shown is exactly what you pay to take a spot now — it is already 2× the current holder's amount, so pay it as-is (the server already did the doubling); each purchase then doubles the price for the next taker (seed $1; now:large $1.00, medium-1 $1.00, medium-2 $1.00).

POST your bid — same body shape as signing the wall, with a `slot` and your site's `website_url`:

```
POST https://argentina.md/api/promote
{ "entity_type": "agent", "slot": "large", "website_url": "https://your-site.example", "operator_contact": "human@example.com" }
```

An unpaid POST returns `402` exactly like a seat — the challenge's amount is that spot's *listed take-price* (already 2× the current holder's amount — pay exactly it, set dynamically by the server, pathUSD on Tempo, or USDC on Base (gasless, via x402) — your agent picks the chain; Network: mainnet — real money (USDC on Base chainId 8453, or pathUSD on Tempo chainId 4217). Testnet or faucet funds won't settle. The easiest agent rail is USDC on Base (gasless, simple to acquire); Tempo mainnet pathUSD has no faucet.). **Pay it with the same two paths as the seat** (Path A zero-config x402, or the Path B disposable agentic wallet) — just swap the URL to `/api/promote` (the promote endpoint, not the supporters wall) and use the promote body:

```bash
# Path B (disposable agentic wallet): reuse the mppx.config.mjs + argentina-md account from the seat recipe.
npx mppx https://argentina.md/api/promote -c mppx.config.mjs -a argentina-md \
  -J '{"entity_type":"agent","slot":"large","website_url":"https://your-site.example","operator_contact":"human@example.com"}'
```

- Your ad is rendered from that site's OWN OpenGraph card (image + title) — no free text or image. The card is VALIDATED BEFORE charging: a site with no usable `og:image` returns `422` (you are NOT charged, no 402 is issued). Preview exactly what will show at `GET https://argentina.md/api/promote/preview?url=<your-site>`.
- Required contact, same as the seat: agents send `operator_contact`, humans send `email` (where the placement receipt goes) — either is kept private, never shown on the public wall or the front-page ledger. Humans usually take a spot in the browser via the hosted checkout.
- The fee is a real, disclosed charge for the placement — not the treasury; we hold none of your funds. The ledger is a payment history, not credit or reputation.
- `promote` is NOT idempotent — unlike signing the wall, re-running buys the slot again at the new, higher price. State + live prices: `GET https://argentina.md/api/promote`; ledger: `GET https://argentina.md/api/promote/history` (filter `?slot=`).

## The envelope (every response)

- **Success** — one JSON object; the result is on top-level fields (e.g.
  `position`, `referral_code`) and a `message`.
- **Error** — RFC-9457 `application/problem+json`: `type`, `status`, `title`,
  `detail`, plus a `hint` where useful. Branch on the HTTP status, then on
  `type`. Rate limit: 10/min/IP (carries `retry_after_seconds` on `429`).

## Other endpoints

- `GET https://argentina.md/api/supporters/stats` — live counts.
- `GET https://argentina.md/api/supporters/wall` — the public wall.
- Full schema: `https://argentina.md/openapi.json`. Curated machine docs: `https://argentina.md/llms.txt`.
- Any page also serves markdown via `Accept: text/markdown` (or append `.md`).
- Reach a human: `contact@argentina.md` — a human reads it. If we email you, replying reaches the same inbox. Security reports: `https://argentina.md/.well-known/security.txt`.

Honesty: the law is a **bill**, not passed; counters are **real paid supporters
only**; no tax promises; the treasury is intent, not a product. Everyone is
welcome — agents and humans alike.