> ## Documentation Index
> Fetch the complete documentation index at: https://noorle.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome to Noorle

> A unified gateway for humans and AI to interact through MCP and A2A protocols

Noorle is a **unified gateway platform** that enables seamless interaction between humans, AI systems, and external services. Whether you're building AI agents, connecting external APIs, or orchestrating multi-agent workflows, Noorle provides the infrastructure to do it all through standardized protocols.

```mermaid theme={null}
graph TD
    subgraph Clients["Clients"]
        direction LR
        C1["MCP Clients"]
        C2["A2A Agents"]
        C3["Chat Channels"]
    end

    subgraph Platform["Noorle Platform"]
        GW["MCP Gateway"]
        AGW["Agent Gateway"]
        AG["Agents"]
    end

    subgraph Capabilities["Capabilities"]
        direction LR
        BI["Built-in"]
        PL["Plugins"]
        CO["Connectors"]
    end

    KB["Knowledge Bases"]

    C1 --> GW
    C2 --> AGW
    C3 --> AG
    GW --> AG
    AGW --> AG
    AG --> Capabilities
    AG --> KB
```

## What is Noorle?

Noorle acts as a central hub that exposes three types of capabilities:

1. **Built-in Capabilities** - Pre-built tools already available in the platform (Files, Web Search, Code Runner, Browser, etc.)
2. **Plugins** - Custom tools you create and deploy as WebAssembly modules
3. **Connectors** - Links to external services via REST APIs or MCP registry servers

All capabilities are unified and exposed through two primary protocols:

* **MCP (Model Context Protocol)** - Standardized tool interface for AI agents to access capabilities
* **A2A (Agent-to-Agent)** - Protocol for direct agent-to-agent communication and collaboration

## Who is Noorle For?

**AI Teams** building agents that need reliable access to tools and external services.

**Integration Builders** connecting disparate systems and APIs without custom glue code.

**Enterprises** needing a secure, multi-tenant platform for AI automation.

**Developers** who want to extend AI capabilities with custom plugins.

## Core Value Proposition

<CardGroup cols={2}>
  <Card title="Unified Architecture" icon="layer-group">
    One gateway, all capabilities. Expose builtin tools, plugins, and connectors through a single interface.
  </Card>

  <Card title="Protocol-Agnostic" icon="plug">
    Connect via MCP (for AI agents) or A2A (for agent-to-agent workflows) with the same underlying capability system.
  </Card>

  <Card title="Secure & Isolated" icon="lock">
    WebAssembly sandbox for plugins. Encrypted credentials for connectors. Account-based resource isolation.
  </Card>

  <Card title="AI-First Design" icon="sparkles">
    Purpose-built for AI agents with memory, knowledge bases, multi-agent workflows, and intelligent tool discovery.
  </Card>
</CardGroup>

## How the Docs are Organized

<CardGroup cols={2}>
  <Card title="Learn Tab" icon="book">
    **You are here.** Deep dives into architecture, concepts, and how Noorle works under the hood.
  </Card>

  <Card title="Use Tab" icon="play">
    Step-by-step guides for common tasks: creating gateways, attaching capabilities, managing agents.
  </Card>

  <Card title="Build Tab" icon="hammer">
    Technical reference for building plugins, connectors, and extending Noorle's capabilities.
  </Card>

  <Card title="Reference Tab" icon="code">
    API documentation, type definitions, and detailed specifications for integration.
  </Card>
</CardGroup>

## Quick Concepts

**MCP Gateway** - A virtual endpoint (mcp-{id}.noorle.com) that exposes capabilities to MCP clients.

**Agent** - An AI system that uses Noorle to access tools and collaborate with other agents.

**Capability** - Any tool or service (builtin, plugin, or connector) that can be invoked.

**Omni Tool** - Intelligent tool discovery that uses AI to automatically find and execute the right tool from available capabilities based on natural language requests.

## Next Steps

<CardGroup cols={3}>
  <Card title="Architecture" icon="diagram-project" href="/docs/learn/architecture">
    Understand how Noorle is structured and how components interact.
  </Card>

  <Card title="Use Cases" icon="lightbulb" href="/docs/learn/use-cases">
    See real-world applications and examples of what you can build.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/docs/learn/quickstart">
    Get a quick orientation before diving deeper into concepts.
  </Card>
</CardGroup>

## Key Features at a Glance

* **Host-Based Routing** - Multiple virtual hosts (console, api, mcp-*, agent-*) on a single server
* **Three-Tier Memory** - Working memory (recent), message journal (permanent), summary memory (LLM-powered)
* **Vector Knowledge Bases** - Semantic search with embeddings and LLM reranking
* **Durable Workflows** - Graph-based, state-machine workflows with approval nodes
* **OAuth & JWT** - Modern auth with device flow, API keys, and stateless tokens
* **Multi-Tenancy** - Complete account isolation with role-based access control

***

Ready to learn more? Start with [Architecture](/docs/learn/architecture) to understand the big picture.