Overview
Complete technical specifications, standards, and quick references for the vCon MCP Server.
Overview
This reference section provides authoritative technical documentation for:
IETF vCon Specifications - Complete standard definitions
Database Schema - PostgreSQL table structures and relationships
MCP Protocol - Model Context Protocol integration details
API Standards - Tool, resource, and prompt specifications
Compliance Matrices - Regulatory framework mappings
Quick References - Fast lookup guides for common tasks
Essential References
🎯 Quick Start References
📋 Specification References
🔧 Implementation References
📚 Feature References
By Use Case
🎯 "I'm implementing vCon for the first time"
Start here: Quick Reference - Know what to avoid
Read: IETF vCon Core - Understand the standard
Reference: Agent database schema - Implement storage
Verify: Implementation Corrections - Check for issues
🔄 "I'm migrating existing vCon code"
Audit: Implementation Corrections - Identify issues
Plan: Migration Guide - Follow migration steps
Verify: Quick Reference - Confirm compliance
Test: Testing Reference - Run compliance tests
🔍 "I'm reviewing vCon code"
Quick check: Quick Reference - Fast verification
Deep check: Implementation Corrections - Known issues
Schema check: Agent database schema - Database compliance
Standards check: vCon Spec - Spec adherence
🛠️ "I'm integrating with MCP"
Protocol: MCP Protocol - Understanding MCP
Tools: ../api/tools.md - Available tools
Resources: ../api/resources.md - Resource URIs
Prompts: ../api/prompts.md - Query templates
📊 "I need compliance documentation"
Overview: Compliance Matrix - All regulations
GDPR: GDPR-specific mappings
CCPA: CCPA-specific mappings
HIPAA: HIPAA-specific mappings
Reference Categories
📖 Standards & Specifications
IETF vCon Standard
vCon Core Specification - Complete IETF draft reference
Main vCon object structure
Party, Dialog, Analysis, Attachment objects
Required vs optional fields
Encoding options
Extensions and must_support
vCon Data Types - Type definitions and validation
TypeScript interfaces
Zod schemas
Validation rules
Example objects
MCP Protocol
MCP Protocol Reference - Complete MCP documentation
Server capabilities
Tool invocation
Resource access
Prompt templates
Error handling
MCP Integration Guide - How to integrate with MCP clients
Claude Desktop setup
Custom client development
Protocol compliance
Testing tools
🗄️ Database & Storage
Agent database schema - Deployed PostgreSQL schema (authoritative for agents)
Core and operational tables, MVs, tenant columns, RLS summary
Pointers to migrations for RPC signatures
Corrected schema - IETF-oriented DDL (not the full catalog)
Search tools - MCP search tools
Keyword, semantic, hybrid, tags
Migrations under
supabase/migrations/- Source of truth forsearch_vcons_*SQL functions and index definitions
🔧 Implementation Guides
Implementation Corrections - Known issues and fixes
Migration Guide - Upgrading from older versions
Testing Reference - Compliance and validation tests
Error Reference - Error codes and handling
📋 Quick References
Quick Reference - Critical corrections checklist
CLI Reference - Command-line tools
Glossary - Terms and definitions
FAQ - Frequently asked questions
✅ Compliance & Standards
Compliance Matrix - All regulatory frameworks
GDPR Compliance - GDPR-specific details
CCPA Compliance - CCPA-specific details
HIPAA Compliance - HIPAA-specific details
Security Standards - Security best practices
🎨 Feature References
Open Source Features - Core functionality
Enterprise Features - Proprietary features
Plugin Architecture - Extension system
Roadmap - Future features and plans
Critical Corrections Summary
This implementation fixes 7 critical issues found in many vCon implementations:
✅ Analysis Schema Field - Uses
schemanotschema_version(Section 4.5.6)✅ Analysis Vendor Requirement -
vendoris required, not optional (Section 4.5.5)✅ Analysis Body Type -
bodyis string type, not object (Section 4.5.7)✅ Party UUID Field - Added per spec Section 4.2.12
✅ Encoding Defaults - No default values, explicit only
✅ Dialog Type Constraints - Must be one of 4 valid types (Section 4.3.1)
✅ Dialog New Fields - Added
session_id,application,message_id
See Quick Reference for detailed checklist.
Specification Sources
Primary Sources
IETF vCon Core:
draft-ietf-vcon-vcon-core-02Location:
../background_docs/draft-ietf-vcon-vcon-core-02.txtWorking Group: https://datatracker.ietf.org/wg/vcon/
IETF vCon Privacy Primer:
draft-ietf-vcon-privacy-primer-00Location:
../background_docs/draft-ietf-vcon-privacy-primer-00.txt
vCon Consent (Draft):
draft-howe-vcon-consent-00Location:
../background_docs/draft-howe-vcon-consent-00.txt
Related Standards
SCITT Architecture:
draft-ietf-scitt-architecture-15For transparency service integration
Location:
../background_docs/draft-ietf-scitt-architecture-15.txt
AI Preferences Vocabulary:
draft-ietf-aipref-vocab-01For AI-related metadata
Location:
../background_docs/draft-ietf-aipref-vocab-01.txt
Version Information
Current Version
Server Version: 1.2.0
vCon Spec Version: 0.4.0 (draft-ietf-vcon-vcon-core-02)
Schema Version: 1.2.0
Last Updated: April 2026
Version History
See Changelog for complete version history.
Compatibility
Node.js: 18.x or higher
PostgreSQL: 15.x or higher
Supabase: Latest stable
MCP SDK: 0.4.x
Contributing to Reference Docs
Reporting Issues
Found an error in the reference documentation?
Check if it's already in Implementation Corrections
Open an issue on GitHub with:
Document name and section
Expected vs actual content
IETF spec reference (if applicable)
Submitting Updates
To update reference documentation:
Verify against IETF spec
Update relevant markdown file
Update cross-references
Submit pull request with changes
See Contributing Guide for details.
Additional Resources
Documentation
User Guides - How to use the server
API Reference - Complete API documentation
Developer Guides - Building and extending
Examples - Code examples and tutorials
External Links
IETF vCon Working Group: https://datatracker.ietf.org/wg/vcon/
MCP Protocol: https://modelcontextprotocol.io/
Supabase Docs: https://supabase.com/docs
pgvector: https://github.com/pgvector/pgvector
Community
GitHub: https://github.com/vcon-dev/vcon-mcp
Issues: Report bugs and request features
Discussions: Ask questions and share ideas
Quick Navigation
By Role
Developers: Quick Reference → vCon Spec → Agent database schema → API Docs
DBAs: Agent database schema → Search tools → Performance Tuning
Integrators: MCP Protocol → API Reference → Integration Guide
Compliance Teams: Compliance Matrix → GDPR → CCPA
By Task
Setting up: Quick Start → Agent database schema → Testing
Migrating: Implementation Corrections → Migration Guide → Testing
Extending: Plugin Architecture → Custom Tools → API Reference
Troubleshooting: Error Reference → FAQ → GitHub Issues
Need help? Check the FAQ or ask in GitHub Discussions.
Found an issue? Report it in GitHub Issues with the documentation label.
Reference documentation is the authoritative source for implementation details. When in doubt, consult the IETF specifications.
Last updated