SDKs

MCP Server

Model Context Protocol server for DeepaData. Enables Claude Desktop, Cursor, and other MCP clients to extract, validate, seal, and verify emotional artifacts.

What is MCP?

The Model Context Protocol (MCP) is an open standard from Anthropic for connecting AI assistants to external tools and data sources. An MCP server exposes capabilities that Claude and other assistants can invoke during conversations.

With the DeepaData MCP server, you can ask Claude to extract emotional context from text, validate artifacts, seal records, or verify .ddna envelopes directly in your conversation.

Installation

Install the MCP server package:

npm install -g @deepadata/mcp-server

Coming Soon: The MCP server package is in development. Check the GitHub repository for release updates.

Configuration

Add the DeepaData server to your Claude Desktop configuration:

claude_desktop_config.json

{
  "mcpServers": {
    "deepadata": {
      "command": "npx",
      "args": ["@deepadata/mcp-server"],
      "env": {
        "DEEPADATA_API_KEY": "dda_live_YOUR_KEY"
      }
    }
  }
}

Config location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Available Tools

The MCP server exposes the following tools to Claude:

deepadata_extract

Extract an EDM artifact from text content. Returns a structured artifact with emotional themes, valence, relationships, and governance metadata.

{
  "content": "Client expressed relief after discussing coping strategies...",
  "jurisdiction": "HIPAA",
  "consent_basis": "consent"
}

deepadata_observe

Capture a salience record at a topic-shift boundary. Lighter-weight than full extraction, focused on detecting emotional shifts.

{
  "content": "The anxiety around presentations has come back...",
  "subject_id": "user-123",
  "session_id": "session-456"
}

deepadata_validate

Validate an artifact against the EDM v0.5.0 schema. Returns validation result with detailed errors if any.

{
  "artifact": { /* EDM artifact object */ }
}

deepadata_seal

Seal an artifact into a .ddna envelope with cryptographic proof. Creates an immutable, verifiable record.

{
  "artifact": { /* EDM artifact object */ },
  "pathway": "subject",
  "authority": "user:vp_12345"
}

deepadata_verify

Verify a .ddna envelope's cryptographic integrity. Returns certification level and signer information.

{
  "envelope": { /* .ddna envelope object */ }
}

Example Usage

Once configured, you can use natural language in Claude Desktop:

"Extract emotional context from this therapy session transcript and show me the primary emotions detected."

"Validate this EDM artifact and tell me if it's compliant with the schema."

"Seal this artifact as a .ddna envelope using the subject pathway."

"Verify this .ddna envelope and show me the certification level."

Environment Variables

Variable	Required	Description
DEEPADATA_API_KEY	required	Your DeepaData API key
DEEPADATA_BASE_URL	optional	API base URL (default: https://www.deepadata.com/api)

Troubleshooting

Server not appearing in Claude

Restart Claude Desktop after editing the config. Check that the config JSON is valid and the API key is set correctly.

Authentication errors

Verify your API key is active and has the required scopes (extract, validate, issue, verify).

Tool invocation failures

Check Claude Desktop logs for detailed error messages. The MCP server logs to stderr.

HTTP API

REST API reference

Node.js SDK

Type-safe client library

MCP Documentation

Model Context Protocol spec

Quick Start

Get started in 5 minutes