Field notes // agents

Book through your AI assistant

Assistants like ChatGPT and Claude can check open times and hold a session for their user through our MCP connector. The client locks the session in themselves through the hold link (free while in proof of concept), then gets their private session pass by email.

Connect

Connector address (Streamable HTTP, no sign-in):

https://freshink.art/api/public/mcp

Client config snippet:

{
  "mcpServers": {
    "fresh-ink": {
      "type": "http",
      "url": "https://freshink.art/api/public/mcp"
    }
  }
}

Prefer REST?

Every MCP tool is also a plain HTTP endpoint, plus events and webhooks.

GET /api/public/studio — studio info.
GET /api/public/availability?from=&to= — open times.
POST /api/public/holds — create a hold (idempotency supported).
GET /api/public/bookings/{id} — booking status.
GET /api/public/events — live availability stream (SSE).
POST /api/public/webhooks — get signed push events.
POST /api/public/agent-keys — optional API key for higher rate limits.

Full spec:

https://freshink.art/api/public/openapi.json

Tools

get_studio_info — Address, hours, session times, and how booking works.
list_open_times — Open times between two dates (up to 31 days).
hold_slot — Holds a time for 15 minutes and returns a lock-in link for the client.
get_booking_status — Pending, confirmed, expired, or cancelled.

Example call:

curl -s https://freshink.art/api/public/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"list_open_times",
                 "arguments":{"from":"2026-10-01","to":"2026-10-07"}}}'

Rules

Confirm name, email, phone, date, and time with the user before holding.
Holds expire after 15 minutes if not locked in. Up to 5 holds per hour per agent.
Proof of concept: booking is free — there is no payment step right now.

Prefer the regular way? Book on the site.