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

# Agent Skill Installer

> Install the Inkwell staking API as a skill in Claude Code, MCP clients, or any AI agent.

# Agent Skill Installer

The Inkwell Agent API can be consumed by AI agents through multiple discovery mechanisms.

## Claude Code Skill

The Inkwell repo includes a native Claude Code skill that teaches Claude how to use the staking API interactively.

### Installation

Clone the skill into your Claude Code skills directory:

```bash theme={null}
cp -r .claude/skills/leviathan-agent ~/.claude/skills/
```

Or if working within the Inkwell repo, it's already available. Invoke it with:

```
/leviathan-agent
```

The skill provides:

* **Decision logic** for when to call each endpoint
* **Multi-step workflows** (allocate -> build tx -> sign -> submit)
* **Tier-aware behavior** (knows which features require builder/pro)

## MCP Server

The `@inkwell.finance/mcp-ika-staking` package exposes the full API as MCP tools and resources.

### Installation

```bash theme={null}
npm install -g @inkwell.finance/mcp-ika-staking
```

### Configuration

Add to your MCP client config (e.g., `claude_desktop_config.json`):

```json theme={null}
{
  "mcpServers": {
    "ika-staking": {
      "command": "mcp-ika-staking",
      "env": {
        "IKA_STAKING_API_KEY": "ink_your_key_here",
        "IKA_STAKING_API_URL": "https://backend.inkwell.finance/api/v1/ika/agent"
      }
    }
  }
}
```

### Available tools

| Tool                    | Description                       |
| ----------------------- | --------------------------------- |
| `ika_health`            | Check API health                  |
| `ika_metadata`          | Get network configuration         |
| `ika_validators_scored` | Get scored validator list         |
| `ika_allocate`          | Compute optimal allocation        |
| `ika_tx_stake`          | Build stake transaction params    |
| `ika_tx_unstake`        | Build unstake transaction params  |
| `ika_tx_withdraw`       | Build withdraw transaction params |
| `ika_rebalance`         | Get rebalance plan                |
| `ika_delegators`        | Get delegator list                |

### Available resources

| Resource           | Description                 |
| ------------------ | --------------------------- |
| `ika://validators` | Full validator set (public) |
| `ika://epoch`      | Current epoch data          |
| `ika://price`      | Latest IKA price            |

## OpenAPI Spec

The raw OpenAPI 3.1 spec is available for any agent framework that consumes OpenAPI:

```
https://docs.inkwell.finance/openapi/leviathan.yaml
```

### Agent discovery

The API serves a plugin manifest for generic agent discovery:

```
https://backend.inkwell.finance/.well-known/ai-plugin.json
```

This follows the OpenAI plugin convention and points to the OpenAPI spec.

## Environment variables

| Variable              | Default                                            | Description        |
| --------------------- | -------------------------------------------------- | ------------------ |
| `IKA_STAKING_API_URL` | `https://backend.inkwell.finance/api/v1/ika/agent` | Agent API base URL |
| `IKA_STAKING_API_KEY` | (none)                                             | Your API key       |