# Sudska Praksa MCPB

[![Sudska Praksa MCPB](https://newreleases.io/badge.svg)](https://newreleases.io/github/sudskapraksa/mcpb)

**sudskapraksa-mcpb** is a bridge that lets any [MCP](https://modelcontextprotocol.io/) client use the [Sudska Praksa](https://sudskapraksa.rs) Semantic Search of Serbian Case Law documents.

It connects to the Sudska Praksa MCP server at `https://mcp.sudskapraksa.rs` using the [Streamable HTTP transport](https://spec.modelcontextprotocol.io/specification/2025-03-26/basic/transports/#streamable-http) and exposes it locally over the MCP [stdio transport](https://spec.modelcontextprotocol.io/specification/basic/transports/#stdio).

## Requirements

- Claude Desktop, or any other application that supports MCPB connectors
- A [Sudska Praksa](https://sudskapraksa.rs) account with an active subscription that includes MCP access

## Install in Claude Desktop

Download [`sudskapraksa.mcpb`](https://github.com/sudskapraksa/mcpb/releases/latest) from the latest release and open it in Claude Desktop. The single package works on all supported platforms (macOS, Linux, Windows).

Once installed, the **Sudska Praksa** tools appear automatically in every conversation.

## First-time authorization

On first use, a browser window opens automatically asking you to sign in to your Sudska Praksa account and grant access. After you authorize, the tokens are saved locally and subsequent uses start without any interaction.

To revoke access, visit your [Sudska Praksa account page](https://sudskapraksa.rs/account).

## How it works

```
Claude Desktop  ──stdio──▶  server/index.js  ──HTTP POST──▶  mcp.sudskapraksa.rs
                ◀──stdio──                   ◀──HTTP resp──
```

When the Sudska Praksa server gains new tools, sudskapraksa-mcpb does **not** need to be updated — it passes raw JSON through without parsing tool schemas.

## License

This application is distributed under the BSD-style license found in the [LICENSE](LICENSE) file.