---
title: bitSimp — Agent Entry Guide
description: Thin entry guide for bitSimp agents, with links to canonical flow docs.
last_updated: 2026-09-11
meta:
  contentType: landing
---

# bitSimp — Agent Entry Guide

> bitSimp is a Bitcoin-only anonymous content marketplace where creators publish paid or free posts and buyers unlock with Lightning.

## Installation

Use the live API; no SDK install is required. For headless LNURL-auth, install the published plugin/skill: https://github.com/dyegolara/lnurl-auth-agents (`npx lnurl-auth ...`).

## Configuration

1. Authenticate with LNURL-auth or NIP-07 and keep the returned session cookie.
2. Send that cookie on authenticated API requests.
3. Alternatively, authenticate a single request with NIP-98 (`Authorization: Nostr <base64 kind-27235 event>`). It acts as an existing Account that has an npub for that one request only — no session, no cookie, one-time use — and covers a fixed subset of operations listed in `/openapi.json`. Lightning-only Accounts are not eligible.
4. Use `/openapi.json` for schemas and `/agents.json` for machine-readable flows.

## Capabilities

| Capability                          | Guide                                                    | Key endpoints                                                                               |
| ----------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| Sign in with Lightning (LNURL-auth) | [/docs/sign-in-lightning.md](/docs/sign-in-lightning.md) | `GET /api/auth/lightning/lnurl-auth/challenge`, `POST /api/auth/lightning/lnurl-auth/login` |
| Sign in with Nostr (NIP-07)         | [/docs/sign-in-nostr.md](/docs/sign-in-nostr.md)         | `GET /api/auth/nostr/nip-07/challenge`, `POST /api/auth/nostr/nip-07/login`                 |
| Link another sign-in method         | [/openapi.json](/openapi.json)                           | `GET/POST /api/auth/link/{lightning,nostr}/...`, `DELETE /api/auth/link`                    |
| Unlock paid posts                   | [/docs/unlock-post.md](/docs/unlock-post.md)             | `POST /api/posts/{postId}/unlock`, `POST /api/posts/{postId}/unlock/confirm`                |
| Publish posts                       | [/docs/publish-post.md](/docs/publish-post.md)           | `POST /api/uploads`, `POST /api/posts`, `GET /api/posts/{postId}`                           |

## Sitemap

See [sitemap](/sitemap.md).