API Documentation:
Parrot-QA Endpoint

https://calvinistparrot.com/api/parrot-qa

The endpoint processes user questions through categorization, reasoning, and review phases. It synthesizes responses to doctrinal queries while supporting multiple denominational modes. Essential doctrines are upheld, including:

• The Trinity: We believe in one God, eternally existing in three persons—Father, Son, and Holy Spirit.
• The Character of God: God is holy, supreme, sovereign, immutable, faithful, good, patient, gracious, merciful, loving, and just; His wrath against sin is real.
• The Authority of Scripture: The Bible is the inspired, inerrant, and infallible Word of God, serving as the ultimate authority in all matters of faith and practice.
• The Deity and Humanity of Christ: We affirm that Jesus Christ is truly God and truly man (Vera Deus, vera homo).
• The Incarnation and Virgin Birth: We affirm that Jesus Christ took on human nature through miraculous conception by the Holy Spirit and was born of the Virgin Mary.
• The Atonement (Christ's Saving Work): Christ's sacrificial death on the cross is necessary and sufficient to reconcile sinners to God.
• The Gospel: We proclaim that salvation is secured by Christ's historical death, burial, and resurrection on the third day, demonstrating His victory over sin and death.
• Justification by Faith: Individuals are justified solely by grace alone through faith alone in Christ alone, apart from works.
• The Resurrection: We affirm the bodily resurrection of Jesus Christ, confirming His divinity and victory over sin and death.
• Christ's Return and Final Judgment: Jesus Christ will return personally and bodily to judge the living and the dead, culminating in the renewal of all things.

Request Body

The API expects a JSON object with these fields:

• question (string, required): The question to ask.
• userId (string, optional): User ID for tracking question history.
• mode (string, optional): Specifies the theological perspective. Possible values:
  • reformed-baptist (default)
  • presbyterian
  • wesleyan
  • lutheran
  • anglican
  • pentecostal
  • non-denom

Response Format

The API streams a multi-stage JSON response:

1. Progress Updates:

   {"type":"progress","message":"[Status message]"}

2. Categorization:

   {"type":"categorization","data":{"category":"[Category]","subcategory":"[Subcategory]","issue_type":"[Type]"}}

3. Agent Responses:

   {"type":"agent_responses","data":{"first_answer":"[Agent 1's answer]","second_answer":"[Agent 2's answer]","third_answer":"[Agent 3's answer]"}}

4. Calvin Review:

   {"type":"calvin_review","content":"[Calvin's synthesized review]"}

5. Reviewed Answer (Streamed):

   {"type":"reviewed_answer","content":"[Final synthesized answer]"}

The API currently employs one reviewer agent, Calvin, who reviews the three agent responses using insights from John Calvin’s "Institutes of the Christian Religion." Additional agents may be added on request.

Request

POST https://calvinistparrot.com/api/parrot-qa
Content-Type: application/json

{
  "question": "Who is God?",
  "mode": "reformed-baptist"
}

Response

{"type":"progress","message":"Understanding question..."}
{"type":"categorization","data":{"reformatted_question":"No reformatting needed","category":"Theology","subcategory":"Doctrine of God (Theology Proper)","issue_type":"Primary"}}
{"type":"progress","message":"Asking the Counsel of Three..."}
{"type":"agent_responses","data":{"first_answer":"God is the creator...","second_answer":"God is the Creator...","third_answer":"God is the Creator..."}}
{"type":"progress","message":"Calvin is reviewing the answers..."}
{"type":"calvin_review","content":"All three answers provide a good understanding of who God is..."}
{"type":"progress","message":"Synthesizing final answer..."}
{"type":"reviewed_answer","content":"God..."}

The API supports the following theological modes:

1. Reformed Baptist (default)
2. Presbyterian
3. Wesleyan
4. Lutheran
5. Anglican
6. Pentecostal/Charismatic
7. Non-Denominational Evangelical

Reformed Baptist

• Baptism: You practice believer's baptism (credo baptism) by immersion, viewing it as an outward sign of inward grace.
• Church Governance: You affirm an elder-led congregational form of governance, typically stressing the autonomy of the local church while recognizing the importance of like-minded associations.
• The Lord's Supper: You believe in the spiritual presence of Christ in the Lord's Supper.
• Spiritual Gifts: You believe in the cessation of spiritual gifts. Believing the miraculous gifts ceased with the apostles, though a minority might be cautious continuationists
• Role of Women in the Church: You adhere to complementarianism.
• Views on Sanctification: You emphasize progressive sanctification by the Holy Spirit, rooted in God’s grace and empowered by the means of grace (Word, prayer, fellowship).
• Continuity and Discontinuity: You hold to covenant theology (sometimes called “1689 Federalism”), seeing continuity between Old and New Covenants while distinguishing the “newness” in Christ.
• Security of Salvation: You believe in the perseverance of the saints—those truly in Christ will be kept by God’s power and not finally fall away.
• The Atonement (How it Works): You hold strongly to penal substitutionary atonement, often emphasizing particular redemption (also called “limited atonement”).

For further questions or support, please reach out!

This is open source, so if you're interested in helping me development this, check out the GitHub repo.