Field Notes // Build On It

Developer portal

A free booking API and MCP server for Fresh Ink sessions. No signup required to start; an optional API key raises your rate limits.

Quickstart

Find open times next week:

curl "https://freshink.art/api/public/availability?from=2026-10-05&to=2026-10-12"

Hold a slot (idempotent — safe to retry with the same key):

curl -X POST https://freshink.art/api/public/holds \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-unique-key-123" \
  -d '{"date":"2026-10-08","time_slot":"1:00 PM","name":"Alex Rivera","email":"alex@example.com","phone":"6515550100"}'

Responses use { data, ... } on success and { error: { code, message } } on failure.

MCP server

Connect any MCP-capable assistant to https://freshink.art/api/public/mcp (Streamable HTTP, no authentication). Tools: get_studio_info, list_open_times, hold_slot, get_booking_status. Full walkthrough on the agent docs page.

API keys & limits

Anonymous: 60 reads/min, 5 writes/hour. Mint a free key with POST /api/public/agent-keys ({email, label?}) for 600 reads/min and 30 writes/hour; send it as Authorization: Bearer. Hitting a limit returns HTTP 429 with a Retry-After header. There is no sandbox environment — the API is read-mostly and holds expire on their own.

Discovery docs

llms.txt — agent-readable summary with when-to-use guidance
developers/llms.txt — scoped context for this portal
openapi.json — machine-readable OpenAPI 3.1 spec
auth.md — authentication model
pricing.md — pricing in markdown
agent card — A2A-style capability card
agent skills index — capability index
MCP server card — branded MCP listing
ard.json — Agentic Resource Discovery catalog
api-catalog — RFC 9727 API catalog

Source code

The site is open source at github.com/Mike-Demo/charm-project-place, with agent instructions in AGENTS.md.