SDKs

MCP Server

Model Context Protocol server for DeepaData. Enables Claude Desktop, Cursor, and other MCP clients to extract, validate, seal, verify, and generate significance wikis from 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, verify .ddna envelopes, generate significance wikis, and route queries by emotional weight directly in your conversation.

Installation

Install the MCP server package:

npx -y deepadata-edm-mcp-server

Configuration

Add the DeepaData server to your Claude Desktop configuration:

claude_desktop_config.json

{
  "mcpServers": {
    "deepadata-edm": {
      "command": "npx",
      "args": ["-y", "deepadata-edm-mcp-server"],
      "env": {
        "DEEPADATA_API_KEY": "dda_live_YOUR_KEY",
        "ANTHROPIC_API_KEY": "sk-ant-YOUR_KEY",
        "DEEPADATA_API_URL": "https://deepadata.com"
      }
    }
  }
}

Get your API key at deepadata.com/platform/api-access-keys

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.

profile— optional — Extraction profile. Accepts essential/extended/full or partner:<profile_id> (e.g. partner:com.deepadata.journaling.v1).

{
  "content": "Client expressed relief after discussing coping strategies...",
  "profile": "partner:com.deepadata.therapy.v1",
  "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.8.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 */ }
}

deepadata_activate

Significance-weighted query routing. Route queries to the most relevant EDM fields based on emotional weight, arc classification, and identity threads.

{
  "query": "Times when I felt overwhelmed by work pressure",
  "namespace": "user_memories",
  "top_k": 5
}

edm_wiki_generate

Generate significance wiki from source text files. Produces wiki_article.md (factual record) and significance_article.md (EDM significance fields) for each input. Requires ANTHROPIC_API_KEY for extraction.

{
  "source_path": "./journal_entries",
  "output_dir": "./wiki",
  "profile": "extended"
  // also accepts partner: prefixed profile IDs
  // e.g. "profile": "partner:com.deepadata.journaling.v1"
}

edm_wiki_search

Search significance wiki by emotional criteria across local significance_article.md files. Filter by arc_type, emotional_weight, identity_thread, or recurrence_pattern.

{
  "wiki_path": "./wiki",
  "arc_type": "grief",
  "emotional_weight_min": 0.75,
  "identity_thread": "professional identity"
}

edm_wiki_lint

Health check and trajectory pattern detection for significance wiki. Reports arc distribution, emotional weight stats, recurring identity threads, missing fields, and temporal span.

{
  "wiki_path": "./wiki"
}

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."

"Generate a significance wiki from my journal entries in ./journal_entries."

"Search the wiki for entries with grief arc_type and emotional weight above 0.8."

"Run a health check on my significance wiki and show me any patterns."

Environment Variables

Variable	Required	Description
DEEPADATA_API_KEY	required	Your DeepaData API key
ANTHROPIC_API_KEY	required	Required for wiki generation tools
DEEPADATA_BASE_URL	optional	API base URL (default: https://deepadata.com)

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