# notebin.ca

> A Markdown note/text bin for creating, rendering, sharing, and managing notes.
> Notes can be public or unlisted, expose rendered reading and raw Markdown URLs,
> and are stored as text with owner metadata for visibility, moderation, and
> lifecycle. Accounts, OAuth, and API keys are federated from pastebin.ca.

## How it works

- Create a note from Markdown using JSON, text/markdown, or multipart/form-data;
  title and description are optional metadata, and signed-in authors may publish
  public notes.
- Public note URLs render Markdown for readers; raw Markdown is available at the
  note's raw URL. Owners can list, inspect, and delete their notes.
- Editor helper endpoints preview Markdown and convert edited HTML back to Markdown;
  the OpenAPI document covers the stable REST create/list/read/delete contract.

## Developer docs

- [Developer guide](https://notebin.ca/docs): REST API, MCP, OAuth, and discovery.
- [OpenAPI 3.1 spec](https://notebin.ca/api/v1/openapi.json): the full REST contract.
- [MCP server](https://notebin.ca/mcp): Model Context Protocol endpoint for AI agents.
- [Agent card](https://notebin.ca/.well-known/agent.json): machine-readable capabilities.
- [MCP discovery](https://notebin.ca/.well-known/oauth-protected-resource/mcp): protected-resource metadata.

## API summary

- POST https://notebin.ca/api/v1/notes — create a Markdown note (scope note:create). JSON {markdown,title,description,visibility}, text/markdown, or multipart/form-data.
- GET https://notebin.ca/api/v1/items/{id} — read note metadata and Markdown where visible (scope note:read for owner API-key reads).
- GET https://notebin.ca/api/v1/account/items — list your notes (scope note:read); filters include q.
- DELETE https://notebin.ca/api/v1/items/{id} — delete one of your notes (scope note:delete).

## Authentication

- Account API keys are minted on https://pastebin.ca and audience-bound to https://notebin.ca.
- Send them as: Authorization: Bearer pbca_live_…
- OAuth 2.1 + PKCE (with optional DPoP) is available for interactive MCP clients;
  pastebin.ca is the authorization server.

## Policy

- Anonymous notes are unlisted; signed-in authors may create public notes when allowed.
- Notes may be moderated or removed for abuse, and owner-only fields expose state
  needed by management clients.
- Privacy: https://notebin.ca/privacy
- Report abuse at https://notebin.ca/abuse.
- The governing family policy lives at https://pastebin.ca/privacy, https://pastebin.ca/terms, and https://pastebin.ca/abuse.