# OpenContracts

> OpenContracts is an open-source document analytics platform for analyzing, annotating, and querying complex documents. It provides a Model Context Protocol (MCP) server for AI agent access.

## MCP Server

This instance exposes a read-only MCP server that AI agents can connect to for accessing public corpuses, documents, annotations, and discussion threads.

- Endpoint (global): http://portal.glitnirhealth.com/mcp/
- Endpoint (corpus-scoped): http://portal.glitnirhealth.com/mcp/corpus/{corpus_slug}/
- Protocol: JSON-RPC 2.0 (MCP spec 2025-03-26)
- Auth: None required (public data only)
- Rate limit: 100 requests/minute per IP

### Connecting

Use any MCP-compatible client. For Claude Desktop, add to config:

```json
{
  "mcpServers": {
    "opencontracts": {
      "command": "npx",
      "args": ["mcp-remote", "http://portal.glitnirhealth.com/mcp/"]
    }
  }
}
```

### Available Tools

- `list_public_corpuses`: List all public corpuses (paginated, searchable)
- `list_documents`: List documents in a corpus
- `get_document_text`: Get full extracted text from a document
- `list_annotations`: List annotations on a document (filter by page or label)
- `search_corpus`: Semantic vector search within a corpus
- `list_threads`: List discussion threads in a corpus
- `get_thread_messages`: Get messages in a thread (flat or hierarchical)

### Available Resources (URI-based)

- `corpus://{corpus_slug}` - Corpus metadata
- `document://{corpus_slug}/{document_slug}` - Document with text
- `annotation://{corpus_slug}/{document_slug}/{annotation_id}` - Annotation details
- `thread://{corpus_slug}/threads/{thread_id}` - Discussion thread

## REST Search API

A simple JSON search endpoint at `http://portal.glitnirhealth.com/api/search/?q=QUERY` is available for crawlers and lightweight integrations.

## Links

- [Full MCP documentation](http://portal.glitnirhealth.com/llms-full.txt)
- [Source code](https://github.com/Open-Source-Legal/OpenContracts)
- [Project documentation](https://contracts.opensource.legal)