NuBerea MCP server

NuBerea AI

Tools for building AI-powered theological study experiences using NuBerea.

This repository contains resources for integrating NuBerea’s biblical research tools with AI assistants, developer frameworks, and the Model Context Protocol (MCP).

What is NuBerea?

NuBerea is an AI-powered theological assistant designed to help users explore Scripture with deeper insight.

It provides tools for:

• Biblical cross-references
• Greek and Hebrew word insights
• Scripture-grounded theological explanations
• AI-assisted sermon preparation and research

Learn more at https://nuberea.com

Model Context Protocol (MCP)

NuBerea provides an MCP server that allows AI clients to securely access NuBerea’s theological tools.

Using MCP, assistants such as ChatGPT, Claude, Cursor, Claude Desktop, or custom agents can interact with NuBerea’s research capabilities as structured tools.

Full documentation: https://nuberea.com/docs/mcp/

Quick Start (any MCP client)

This is the universal path for ChatGPT, Cursor, Claude Desktop, custom agents, and any other MCP-compatible client.

1. Create an account

Sign in or create a NuBerea account at https://nuberea.com/login.

2. Add NuBerea to your MCP client

Point your client at the NuBerea MCP server URL:

https://mcp.nuberea.com/mcp

Example MCP configuration:

{
  "mcpServers": {
    "nuberea": {
      "url": "https://mcp.nuberea.com/mcp"
    }
  }
}

3. Authenticate

NuBerea MCP uses token-based authentication with refresh tokens to maintain secure, long-lived sessions. Your client will prompt you to sign in on first use. See the docs for client-specific setup.

Claude Code plugin

If you use Claude Code, NuBerea ships as a first-class plugin.

This repository follows Claude Code's marketplace layout:

• .claude-plugin/marketplace.json defines the marketplace catalog.
• .claude-plugin/plugin.json defines the NuBerea plugin.

Install

Choose one of the marketplace sources below. The Anthropic Community marketplace is recommended for most users; use the GitHub source if you want preview builds direct from this repo.

To scope a marketplace to a single repository instead of your user profile, append --scope project to the marketplace add command.

Restart Claude Code after updating so the new plugin version is loaded.

Use

Start Claude Code:

claude

Authenticate NuBerea (first run only):

/mcp

Select nuberea and complete the authentication flow.

Try a prompt such as:

Use Nuberea to look up John 1:1 in Greek and summarize the lexical notes.

Troubleshooting

List configured marketplaces:

claude plugin marketplace list

List installed plugins:

claude plugin list

Check whether the MCP server is connected:

claude mcp list

Or inside Claude Code, run /mcp.

If NuBerea shows Needs authentication, run /mcp, select nuberea, and complete authentication. If authentication succeeds but reconnection fails, restart Claude Code.

Shortened. The full README is on GitHub.