Documentation

Build with Artificial ID

Everything you need to integrate AI identity into your workflow — MCP, REST API, browser extension, and more.

API Base URLapi.artificial-id.com/v1

Jump to

QuickstartAuthenticationBlueprint SchemaPersonasWebhooksRate Limits
Start here

Getting Started

Create your first AI behavioral blueprint through a guided interview. Learn how the 4-layer, 10+ module system captures your identity.

Interview walkthrough
Blueprint overview
First API call
Read docs
25 endpoints

API Reference

25 REST endpoints covering blueprints, personas, watermarking, and distribution. Full OpenAPI spec included.

GET /blueprint
GET /personas
POST /watermark/verify
Read docs
Real-time

MCP Server

Connect your AI-ID to Claude, Cursor, and any MCP-compatible tool. Real-time blueprint sync with a single config change.

npx @artificial-id/mcp
JSON config snippet
Supported clients
Read docs
5+ platforms

Browser Extension

Auto-inject your identity into ChatGPT, Claude, Gemini, and 5+ AI platforms. Set it up once, forget about it.

Installation guide
Platform support
Custom injection rules
Read docs
Zero-knowledge

Security & Encryption

Deep dive into AES-256-GCM client-side encryption, Google Drive key storage, HMAC-SHA256 watermarking, and the zero-knowledge architecture.

Encryption model
Key management
Watermark verification
Read docs
Universal

Markdown Export

Export your blueprint as structured markdown for manual injection into any AI system prompt or custom instructions field.

Export formats
System prompt template
Custom instructions
Read docs

Examples

Common patterns

Get up and running in minutes

Fetch your blueprint
curl https://api.artificial-id.com/v1/blueprint \
  -H "Authorization: Bearer <API_KEY>"
MCP config
{
  "mcpServers": {
    "artificial-id": {
      "command": "npx",
      "args": ["-y", "@artificial-id/mcp"],
      "env": { "AIID_API_KEY": "<API_KEY>" }
    }
  }
}
Verify watermark
curl -X POST https://api.artificial-id.com/v1/watermark/verify \
  -H "Authorization: Bearer <API_KEY>" \
  -d '{"content": "...", "signature": "..."}'

Blueprint Schema

4 Layers, 10+ Modules

The Artificial ID blueprint is a structured JSON document organized into 4 semantic layers. Each layer maps to a specific dimension of your AI identity.

View Schema Reference
Layer 1Core Identity

name, role, communication_style, work_preferences

Layer 2Voice & Tone

formality, verbosity, humor, preferred_format

Layer 3Code DNA

languages, frameworks, style, tools, philosophy

Layer 4Knowledge Base

domains, reasoning_style, mental_models, biases

Ready to integrate?

Create a free account, complete the AI interview, and start distributing your identity in under 20 minutes.

Create Free AccountFull API Reference
API Base:api.artificial-id.com/v1