Alpha 02 · AI integration · Read only

Give AI the same source of truth.

The Nikba MCP server connects compatible AI hosts directly to published components, product patterns, integrations, guides, and design tokens.

01 · Architecture

One contract from source to output

The server reads only versioned files shipped with the package. It does not modify projects, call external services, or collect prompts.

  1. 01Source filesTokens and component contracts
  2. 02Nikba MCPDiscoverable, structured context
  3. 03AI hostImplementation with public APIs
Published context36 documents

Twenty-three component contracts, five product patterns, two integrations, and six system guides.

Query surface6 tools

Discover, retrieve, filter, and search the installed system without external calls.

Implementation prompt1 guided workflow

The host inspects relevant contracts and tokens before generating interface code.

02 · Resources

Published knowledge

Hosts can discover stable URIs and read the exact documentation included in the installed package.

Overviewnikba://system/overview

Principles, setup, usage, and the current public surface.

Tokensnikba://foundations/tokens

Primitive, semantic, and theme CSS custom properties.

Componentsnikba://components/{slug}

Purpose, API, variants, states, accessibility, examples, and acceptance criteria for every documented component.

Patternsnikba://patterns/{slug}

Product compositions, validation, settings, and confirmation guidance.

Integrationsnikba://integrations/{slug}

Lifecycle and ownership boundaries for Livewire and Filament.

Guidesnikba://guides/{slug}

Foundations, support, release, and migration policy.

03 · Tools

Focused retrieval for AI

Every tool is read only, deterministic for a given package version, and limited to Nikba Design System files.

list_components
Discover component names, descriptions, slugs, and resource URIs.
get_component
Read the complete contract for a component by slug.
list_documents
Discover all documentation or one component, pattern, integration, or guide category.
get_document
Read one complete document by category and slug.
get_tokens
Read all design tokens or one primitive, semantic, or theme layer.
search_design_system
Find relevant guidance across the complete published system.
Prompt
build_with_nikba

Directs the host to inspect relevant contracts and tokens before implementing an interface.

04 · Connect

Start through standard input and output

Run the server locally, then register its executable in any compatible MCP host.

Terminal 
npm run mcp
Host configuration 
{
  "mcpServers": {
    "nikba-design-system": {
      "command": "nikba-design-system-mcp"
    }
  }
}
Protocol verified

The automated test performs a real MCP handshake, discovers capabilities, invokes tools, and reads a resource.