open-index/open-npm huggingface dataset:
npm package: @provenedge/realize-mcp
Description: MCP server for ProvenEdge Realization Engine — connect AI agents to your entities, records, views, and documents
Latest version: 0.1.2

# @provenedge/realize-mcp

MCP server for the [ProvenEdge](https://provenedge.com) Realization Engine. Connects AI agents (Claude Code, Cursor, Windsurf, etc.) to your entities, records, views, relationships, and documents via the [Model Context Protocol](https://modelcontextprotocol.io).

## Quick Start

No install needed — just configure your AI client:

**Claude Code** (`.mcp.json` in project root or `~/.claude/.mcp.json` globally):

```json
{
  "mcpServers": {
    "provenedge": {
      "command": "npx",
      "args": ["-y", "@provenedge/realize-mcp"],
      "env": {
        "SCAFFOLD_API_URL": "https://api.provenedge.com",
        "SCAFFOLD_API_KEY": "pe_live_..."
      }
    }
  }
}
```

Then restart your AI agent to pick up the new server.

## Getting an API Key

1. Log in to your ProvenEdge workspace
2. Go to **Settings > API Keys**
3. Create a key with **READ** or **READ_WRITE** scope
4. Copy the key (it's only shown once)

## Environment Variables

| Variable | Required | Description |
|---|---|---|
| `SCAFFOLD_API_KEY` | Yes | Your API key (`pe_live_...`) |
| `SCAFFOLD_API_URL` | No | API base URL (defaults to `http://localhost:4000`) |

## Available Tools

27 tools across these categories:

| Category | Tools | Scope |
|---|---|---|
| **Entities** | list, get, create, update, delete, stats | READ / READ_WRITE |
| **Fields** | list, add, update, delete | READ / READ_WRITE |
| **Records** | list, get, create, update, delete, search | READ / READ_WRITE |
| **Views** | list, get, create, execute, delete | READ / READ_WRITE |
| **Relationships** | list, create, get_related, link, unlink | READ / READ_WRITE |
| **Notes** | list, add | READ / READ_WRITE |
| **Import** | csv | READ_WRITE |
| **Audit** | get_audit_log | READ |
| **Profile** | get_profile, get_storage_usage | READ |
| **Documents** | list_documents | READ |

## Supported Clients

| Client | Config Location |
|---|---|
| **Claude Code** | `.mcp.json` in project root or `~/.claude/.mcp.json` |
| **Cursor** | Settings > MCP Servers or `~/.cursor/mcp.json` |
| **Windsurf** | Settings > MCP |
| **Continue** | `~/.continue/config.json` under `mcpServers` |
| **Cline** | Settings > MCP Servers |

## Pin a Version

```json
"args": ["-y", "@provenedge/realize-mcp@0.1.0"]
```

## Security

- API keys authenticate as USER role (never elevated, even if the user has ADMIN/SUPERADMIN)
- READ keys can only read data; READ_WRITE keys can modify data
- Keys can be revoked instantly from the web UI
- Rate limited: 100 requests/minute per key

## License

MIT
npm package: @provenix/sdk
Description: Official JavaScript/TypeScript SDK for Provenix - cryptographic text provenance
Author: Kevin Dunne
Latest version: 0.1.0-preview

# @provenix/sdk

Official JavaScript/TypeScript SDK for [Provenix](https://provenix.dev) - cryptographic text provenance.

**AI detection is guesswork. Provenance is evidence.**

## Installation

```bash
npm install @provenix/sdk
# or
pnpm add @provenix/sdk
# or
yarn add @provenix/sdk
```

## Quick Start

```typescript
import { ProvenixClient } from '@provenix/sdk'

// Initialize client with API key
const client = new ProvenixClient({
  apiKey: 'prov_live_...'
})

// Sign text
const manifest = await client.sign('Hello world', {
  author: 'user@example.com'
})

// Verify text
const result = await client.verify('Hello world', manifest)
console.log(result.valid) // true
```

## API Reference

### `ProvenixClient`

#### `sign(text: string, metadata?: object): Promise<SignResponse>`

Generate cryptographic manifest for text.

**Parameters:**
- `text` - Text to sign (max 1MB)
- `metadata` - Optional metadata object (max 10KB)

**Returns:**
```typescript
{
  hash: string           // SHA-256 hash of text
  signature: string      // Ed25519 signature
  manifest: {
    hash: string
    timestamp: string    // ISO 8601
    metadata?: object
    version: string
  }
  publicKey: string      // For verification
}
```

#### `verify(text: string, manifest: SignResponse): Promise<VerifyResponse>`

Verify text against signed manifest.

**Parameters:**
- `text` - Text to verify
- `manifest` - Previously generated manifest

**Returns:**
```typescript
{
  valid: boolean         // Overall verification result
  hashMatch: boolean     // Text hash matches manifest
  signatureValid: boolean // Signature is valid
  timestamp: string
  metadata?: object
  warnings?: string[]    // Optional warnings (e.g., stale timestamp)
}
```

## Error Handling

```typescript
import { ProvenixClient, ProvenixError } from '@provenix/sdk'

try {
  const manifest = await client.sign(text)
} catch (error) {
  if (error instanceof ProvenixError) {
    console.error(`Error ${error.code}: ${error.message}`)
  }
}
```

## License

MIT
npm package: @provenix/widget
Description: Embeddable verification widget for Provenix manifests
Author: Kevin Dunne
Latest version: 0.1.1-preview

# @provenix/widget

Embeddable verification widget for Provenix manifests.

## Usage

```html
<!-- Include the widget script -->
<script src="https://cdn.provenix.dev/widget.js"></script>

<!-- Add verification badge -->
<provenix-widget
  manifest='{"hash":"...","timestamp":"..."}'
  signature="...">
</provenix-widget>
```

## Development

```bash
# Build widget
pnpm --filter=widget build

# Watch mode
pnpm --filter=widget dev
```

## Implementation Status

⚠️ **Under Construction** - Widget awaits API implementation and discovery validation.

## License

MIT