plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "urantia-papers",
  "version": "1.4.0",
  "description": "Search and read the Urantia Papers in English and Spanish: paragraph lookup by reference, keyword and semantic search, named entities, and cross-references to the Bible and 21 other public domain texts, scriptures and classics. 26 read-only tools.",
  "author": {
    "name": "Urantia.dev",
    "email": "kelson@urantia.dev",
    "url": "https://urantia.dev"
  },
  "homepage": "https://docs.urantia.dev/mcp-servers",
  "repository": "https://github.com/urantia-hub/urantia-papers-claude-code-plugin",
  "license": "MIT",
  "keywords": [
    "urantia",
    "urantia-papers",
    "urantia-book",
    "bible",
    "search",
    "semantic-search",
    "reference"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Urantia Papers",
        "shortDescription": "Search, read, and cite",
        "longDescription": "Urantia Papers gives the assistant direct, structured access to the text of the Urantia Papers, a public domain text of 196 papers and a Foreword.\n\nWhat it does:\n- Fetches any paper, section, or paragraph by reference, such as 2:0.1, with the paragraphs around it.\n- Reads and searches a Spanish translation of the whole text as well as the English text.\n- Searches the whole text by keyword or exact phrase, or by meaning.\n- Looks up more than 4,400 named beings, places, and concepts, and finds the paragraphs that name each one.\n- Reads and searches the Bible and 21 other public domain texts, scriptures and classics such as the Dhammapada, the Bhagavad Gita, the Koran, and the Tao Te Ching. Finds the Urantia paragraphs nearest in meaning to a passage, and the Bible verses nearest to a paragraph.\n- Checks a quotation against the text and returns a citation of a paragraph in APA, MLA, Chicago, or BibTeX.\n- Returns links to narration audio for a paragraph.\n\nIt is for readers, students, and researchers who want quoted passages with exact references, and for developers who build study tools.\n\nLimits: every tool only reads, and nothing is saved for the user. There is no account or sign-in. The Spanish text is a machine translation, labeled as one on each paragraph; the other texts are in English. The cross-references are ranked by similarity of meaning; they are not a curated list. Each other text is one public domain translation. The plugin quotes the text and does not interpret it for the user.\n\nThis is an independent community project. It is not affiliated with Urantia Foundation.",
        "developerName": "Urantia.dev",
        "category": "Education & Research",
        "capabilities": [
          "Search the text by keyword or meaning",
          "Read papers and paragraphs by reference",
          "Read and search the text in Spanish",
          "Look up named beings, places, and concepts",
          "Find related Bible passages",
          "Read texts of other traditions"
        ],
        "websiteURL": "https://urantia.dev",
        "supportURL": "https://docs.urantia.dev/help",
        "privacyPolicyURL": "https://docs.urantia.dev/privacy-policy",
        "termsOfServiceURL": "https://docs.urantia.dev/terms-of-service",
        "defaultPrompt": [
          "What do the Urantia Papers say about the Thought Adjuster? Quote the paragraphs with references.",
          "Show me paragraph 2:5.10 of the Urantia Papers with the paragraphs around it.",
          "Which Urantia paragraphs are closest in meaning to Matthew 5:3?"
        ],
        "brandColor": "#0f2a2e",
        "brandColorDark": "#f2b441",
        "composerIcon": "./assets/icon.png",
        "composerIconDark": "./assets/icon-dark.png",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png"
      },
      "onboardingSkill": "./skills/urantia-research/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Study a topic and get quoted passages with references",
              "prompt": "What do the Urantia Papers say about the Thought Adjuster? Quote the paragraphs and give the references.",
              "tools_triggered": "search.semantic, search.fulltext, entities.list",
              "expected_behavior": "Returns several quoted paragraphs about the Thought Adjuster, each with its reference in paper:section.paragraph form, such as 107:0.2, 110:1.1, or 110:4.2. The quotes match the tool results."
            },
            {
              "description": "Read a known paragraph in context",
              "prompt": "Show me paragraph 2:5.10 of the Urantia Papers with the two paragraphs before and after it.",
              "tools_triggered": "paragraphs.context",
              "expected_behavior": "Returns paragraph 2:5.10, which begins \"But the love of God is an intelligent and farseeing parental affection\", with paragraphs 2:5.8, 2:5.9, 2:5.11, and 2:5.12 around it."
            },
            {
              "description": "Read and summarize a whole paper",
              "prompt": "Summarize Paper 1 of the Urantia Papers and cite the paragraphs you use.",
              "tools_triggered": "papers.get",
              "expected_behavior": "Fetches Paper 1, \"The Universal Father\" (70 paragraphs), and returns a summary with references such as 1:0.1."
            },
            {
              "description": "Look up a named being",
              "prompt": "Who is Machiventa Melchizedek in the Urantia Papers?",
              "tools_triggered": "entities.list, entities.get, entities.paragraphs",
              "expected_behavior": "Identifies Machiventa Melchizedek as a Melchizedek Son who appeared at Salem, and gives paragraph references for each statement, such as 93:1.3 and 93:2.1."
            },
            {
              "description": "Read a paragraph in Spanish",
              "prompt": "Mu\u00e9strame el p\u00e1rrafo 2:5.10 de los Documentos de Urantia en espa\u00f1ol.",
              "tools_triggered": "paragraphs.get",
              "expected_behavior": "Returns paragraph 2:5.10 in Spanish, which begins \"Pero el amor de Dios es un afecto paternal inteligente y previsor\", with its reference and a note that it is a machine translation."
            },
            {
              "description": "Find Urantia paragraphs related to a Bible verse",
              "prompt": "Which Urantia paragraphs are closest in meaning to Matthew 5:3?",
              "tools_triggered": "bible.verse.urantia_parallels",
              "expected_behavior": "Returns the closest Urantia paragraphs ranked by similarity of meaning. The first is 140:3.3, followed by 140:5.7 and 140:3.5."
            }
          ],
          "negative": [
            {
              "description": "A write request. The plugin only reads and has no accounts, so the assistant must say it cannot save a note through this plugin.",
              "prompt": "Add a note to paragraph 2:5.1 and save it to my account."
            },
            {
              "description": "A text the plugin does not carry. It serves the Urantia Papers, the World English Bible, and the 21 other texts that works.list returns beside the Bible, and the Avesta is not one of them. The assistant must say the plugin has no Avesta text and must not present Avesta passages as coming from this plugin. It can answer from another source.",
              "prompt": "Use the Urantia Papers plugin to quote what the Avesta says about truth."
            },
            {
              "description": "A reference that does not exist. The papers end at 196, so the tool returns not found and the answer must say so without inventing text.",
              "prompt": "Show me paragraph 250:1.1 of the Urantia Papers."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "demo_recording_url": "https://youtu.be/-2WJRON0ZOE"
      },
      "publication": {
        "release_notes": "The text in Spanish too: the paper, paragraph, and search tools take lang \"es\". 26 read-only tools: the Urantia Papers, the World English Bible, and 21 other public domain texts (scriptures and classics), with quote checks and citations, plus a research skill for cited answers."
      },
      "apps": "./.app.json"
    }
  }
}