Adaptive Sentience

Developer Platform

Extensible tool catalog, MCP integration, and local development workflow

Tool Contracts & Catalog

Tools are defined with JSON schemas for inputs and outputs. The platform validates requests, tracks versions, and provides execution metadata.

Example Tool Definition

{
  "tool_id": "tool:pii_redact",
  "name": "pii_redact",
  "version": "1.0.0",
  "description": "Redact PII from text (emails, phones, SSNs)",
  "input_schema": {
    "type": "object",
    "properties": {
      "text": { "type": "string" }
    },
    "required": ["text"]
  },
  "output_schema": {
    "type": "object",
    "properties": {
      "redacted_text": { "type": "string" },
      "redactions": { "type": "array" }
    }
  },
  "required_capabilities": ["tool:pii_redact"],
  "deterministic": true
}

MCP Integration

JSON-RPC 2.0 server exposes tool catalog to AI assistants and IDEs. Tools discoverable via /v1/mcp endpoint.

# MCP Server
python -m gateway.mcp_server_cli \
  --host 127.0.0.1 --port 8790

Local Dev Loop

Run gateway and edge nodes locally. Test workflows with demo scripts.

# Terminal 1: Gateway
python -m gateway.http_gateway

# Terminal 2: Edge Node
cd edge_node && python node.py

# Terminal 3: Test
python demos/llm_client_demo.py

HTTP API Example

Tool Call Request

POST /v1/tool_call

{
  "target": { "kind": "local" },
  "tool_name": "pii_redact",
  "tool_args": { "text": "Contact john@example.com" },
  "token": { "capabilities": ["tool:pii_redact"] }
}

Response:
{
  "ok": true,
  "verified": true,
  "result": {
    "redacted_text": "Contact [REDACTED]",
    "redactions": [{"type": "email", "start": 8, "end": 25}]
  },
  "execution_path": ["local:abc123"],
  "degraded": false
}

Comprehensive Documentation

Detailed guides, API reference, and tutorials for building on Adaptive Sentience

📚 ReadTheDocs

Full documentation including quickstart guides, core concepts, API reference, and deployment instructions.

View Documentation

Quick links:
Quickstart •Core Concepts •API Reference

Build on the Platform

Extensible tool registry • MCP-ready • Version-aware execution • Execution evidence