For AI and agents

Verse2Note can mint the same link — themed collections and a reading-plan day — for Grok, Claude, Cursor, or any agent. No account. The model calls the API; it should not invent the URL.

API

GET /api/link for a reference. GET /api/collections for a theme. GET /api/plans?id=gospels-30&day=1 for a plan day.

GET

GET /api/link?ref=John+3:16&app=youversion&locale=en

GET /api/collections

GET /api/collections?id=salvation&app=youversion&locale=pt

GET /api/plans

GET /api/plans?id=gospels-30&day=1&app=youversion&locale=pt

POST /api/link

{
  "refs": ["John 3:16", "Romans 8:28"],
  "app": "youversion",
  "locale": "en"
}

Skill

Drop the skill into Claude, Grok Build, or Cursor. The agent reads the rules and calls this site's API.

Open skill.md

MCP

JSON-RPC at POST /api/mcp. verse2note_link, verse2note_collection, and verse2note_plan.

POST /api/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "verse2note_link",
    "arguments": { "ref": "John 3:16", "app": "youversion", "locale": "en" }
  }
}

verse2note_collection

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "verse2note_collection",
    "arguments": { "id": "salvation", "app": "youversion", "locale": "pt" }
  }
}

verse2note_plan

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "verse2note_plan",
    "arguments": { "id": "gospels-30", "day": 1, "app": "youversion", "locale": "pt" }
  }
}

App ids

  • YouVersion (Bible App)youversion
  • Life Bible (Tecarta)tecarta
  • Logoslogos
  • Olive Treeolive-tree
  • Bible Gatewaybible-gateway
  • Blue Letter Bibleblue-letter
  • ESV.org (Crossway)esv
  • Bíblia Onlinebiblia-online
  • Bible Hubbible-hub
  • Accordanceaccordance
  • e-Sworde-sword
  • MySwordmysword
  • JW Libraryjw-library