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

# Overview

> Connect your applications, coding agents and AI platforms to Silmaril Firewall.

# Silmaril

Protect model requests, responses and tool activity with Silmaril Firewall. Connect through your application, coding agents or AI platform.

## Choose your path

[Protect an AI application&#x20;
Use a language SDK or framework integration to check model and tool activity in your application.](https://silmaril.dev/docs/start/quickstart.md)

[Deploy on macOS&#x20;
Protect local coding agents with a direct install or a managed rollout through your MDM.](https://silmaril.dev/docs/macos.md)

[Connect an AI platform&#x20;
Connect Claude Enterprise, LiteLLM, Vercel AI Gateway, Bedrock AgentCore, Azure Foundry or Google Cloud.](https://silmaril.dev/docs/gateways/overview.md)

## Classify a request

```typescript TypeScript theme={"theme":"github-light-default"}
import { Firewall, HookLabel } from "@silmaril-security/sdk"

const fw = new Firewall({
  apiKey: process.env.SILMARIL_API_KEY!,
  apiUrl: process.env.SILMARIL_API_URL!,
})
const userInput = "Summarize this release note."
const result = await fw.classify(userInput, {
  hook: HookLabel.USER_INPUT,
})
console.log(result.prediction)
```

```python Python theme={"theme":"github-light-default"}
import os
from silmaril_security.sdk import Firewall, HookLabel

fw = Firewall(
    api_key=os.environ["SILMARIL_API_KEY"],
    api_url=os.environ["SILMARIL_API_URL"],
)
user_input = "Summarize this release note."
result = fw.classify(
    user_input, hook=HookLabel.USER_INPUT,
)
print(result.prediction)
```

```go Go theme={"theme":"github-light-default"}
package main

import (
    "context"
    "log"
    "os"
    "github.com/Silmaril-Security/sdk-go/firewall"
)

func main() {
    fw, err := firewall.New(firewall.Options{
        APIKey: os.Getenv("SILMARIL_API_KEY"),
        APIURL: os.Getenv("SILMARIL_API_URL"),
    })
    if err != nil { log.Fatal(err) }

    result, err := fw.Classify(context.Background(),
        "Summarize this release note.",
        firewall.WithHook(firewall.HookUserInput),
    )
    if err != nil { log.Fatal(err) }
    log.Println(result.Prediction)
}
```

```java Java theme={"theme":"github-light-default"}
import dev.silmaril.security.Firewall;
import dev.silmaril.security.HookLabel;
import dev.silmaril.security.ClassifyOptions;

public class Example {
    public static void main(String[] args) throws Exception {
        var fw = Firewall.builder()
            .apiKey(System.getenv("SILMARIL_API_KEY"))
            .apiUrl(System.getenv("SILMARIL_API_URL"))
            .build();

        var result = fw.classify(
            "Summarize this release note.",
            ClassifyOptions.builder()
                .hook(HookLabel.USER_INPUT)
                .build()
        );
        System.out.println(result.prediction());
    }
}
```

Start with the [quick start](https://silmaril.dev/docs/start/quickstart.md). Apply the returned decision with your chosen [enforcement mode](https://silmaril.dev/docs/guides/enforcement.md).

## Language SDKs

Add checks where your application receives input, calls tools and returns model output.

[
TypeScriptSDK 0.10.0](https://silmaril.dev/docs/sdk/typescript.md#install)

[
PythonSDK 0.10.0](https://silmaril.dev/docs/sdk/python.md#install)

[
GoSDK 0.8.0](https://silmaril.dev/docs/sdk/go.md#install)

[
JavaSDK 0.7.0](https://silmaril.dev/docs/sdk/java.md#install)

## AI platforms and gateways

Choose your platform for connection settings, model and tool routes, and enforcement.

> [card] [Claude Enterprise](https://silmaril.dev/docs/integrations/claude-enterprise.md)
>
> Connect conversations and tool calls through native inference hooks.

> [card] [LiteLLM](https://silmaril.dev/docs/integrations/litellm.md)
>
> Add pre-call and post-call guardrails to your proxy.

> [card] [Vercel AI Gateway](https://silmaril.dev/docs/gateways/vercel.md)
>
> Wrap gateway models with Silmaril middleware.

> [card] [Bedrock AgentCore](https://silmaril.dev/docs/integrations/bedrock-agentcore.md)
>
> Check model and MCP traffic through Gateway interceptors.

> [card] [Azure Foundry](https://silmaril.dev/docs/integrations/azure-foundry.md)
>
> Configure Foundry model and tool routes in Azure API Management.

> [card] [Google Cloud](https://silmaril.dev/docs/integrations/google-agent-gateway.md)
>
> Configure Agent Runtime model and tool routes through Agent Gateway.

## Integrate and operate

[Coding agentsSet up Codex, Claude Code, Pi, and other supported agent plugins.](https://silmaril.dev/docs/integrations/agent-plugins.md)
[Framework SDKsAdd protection to Vercel AI SDK, LangChain, or LangGraph.](https://silmaril.dev/docs/integrations/frameworks.md)
[Verify protectionConfirm traffic, connected boundaries, and blocking behavior.](https://silmaril.dev/docs/start/verify.md)
[Firewall MCPLet your MCP client investigate findings and traffic.](https://silmaril.dev/docs/integrations/firewall-mcp.md)
[Self-hostingPlan a deployment in your cloud account with Silmaril.](https://silmaril.dev/docs/deployment/self-hosting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.