npm package: @kasarlabs/ask-starknet-help-mcp
Description: Help and documentation MCP server for Ask Starknet: usage guide, architecture explanation, capabilities listing, and project ideas
Author: kasarlabs
Latest version: 0.1.0

# Ask Starknet Help MCP Server

Documentation and discovery MCP server for Ask Starknet. This MCP provides tools to explore Ask Starknet's architecture, capabilities, project ideas, and usage guide.

## Features

- **Quick Start Guide**: Get help on how to use Ask Starknet with setup instructions and best practices
- **Architecture Explanation**: Understand how Ask Starknet's unified router and MCP servers work together
- **Capabilities Listing**: Discover all available MCPs organized by domains (wallets, DeFi, blockchain, dev-tools, special)
- **Project Ideas**: Get inspired with project ideas that can be built using Ask Starknet

## Installation

```bash
npx -y @kasarlabs/ask-starknet-help-mcp
```

## Available Tools

### 1. `ask_starknet_help`

Get comprehensive help on using Ask Starknet, including quick start guide, setup instructions, best practices, and troubleshooting.

**Parameters:**

None (empty object)

**Example:**

```json
{}
```

**Response:**

Returns a markdown-formatted help guide with:

- What is Ask Starknet
- Quick start examples
- Setup instructions (minimal and full)
- Best practices
- Troubleshooting tips

```json
{
  "status": "success",
  "data": "# Ask Starknet Help Guide\n\nWelcome to Ask Starknet!..."
}
```

### 2. `ask_starknet_explain_architecture`

Explains the Ask Starknet architecture and how it works.

**Parameters:**

- `topic` (optional): `"router"` | `"mcps"` | `"interaction"` | `"all"`

**Example:**

```json
{
  "topic": "router"
}
```

**Response:**

```json
{
  "status": "success",
  "data": {
    "overview": "...",
    "unifiedRouter": {
      "description": "...",
      "howItWorks": "...",
      "technologies": [...]
    }
  }
}
```

### 3. `ask_starknet_list_capabilities`

Lists all Ask Starknet capabilities organized by domains.

**Parameters:**

- `domain` (optional): `"wallets"` | `"defi"` | `"blockchain"` | `"dev-tools"` | `"special"` | `"all"`
- `mcp` (optional): Filter by specific MCP name (e.g., `"avnu"`, `"erc20"`)

**Example:**

```json
{
  "domain": "defi"
}
```

**Response:**

```json
{
  "status": "success",
  "data": {
    "domains": {
      "defi": {
        "description": "...",
        "mcps": {
          "avnu": {
            "description": "...",
            "tools": [...],
            "expertise": "...",
            "toolCount": 2
          }
        }
      }
    },
    "statistics": {
      "totalMCPs": 20,
      "totalTools": 150,
      "mcpsByDomain": {...}
    }
  }
}
```

### 4. `ask_starknet_suggest_projects`

Suggests project ideas that can be built with Ask Starknet.

**Parameters:**

- `domain` (optional): `"defi"` | `"nft"` | `"trading"` | `"automation"` | `"analytics"` | `"gaming"` | `"all"`
- `mcps` (optional): Filter projects using specific MCPs (e.g., `["avnu", "ekubo"]`)

**Example:**

```json
{
  "domain": "defi",
  "mcps": ["avnu", "ekubo"]
}
```

**Response:**

```json
{
  "status": "success",
  "data": {
    "projects": [
      {
        "name": "Multi-DEX Swap Aggregator",
        "description": "...",
        "domain": "defi",
        "requiredMCPs": ["avnu", "ekubo", "fibrous"],
        "features": [...]
      }
    ],
    "totalProjects": 5
  }
}
```

## Domains

Ask Starknet organizes MCPs into the following domains:

- **Wallets**: `argent`, `braavos`, `okx`, `openzeppelin`
- **DeFi**: `avnu`, `ekubo`, `endurfi`, `extended`, `fibrous`, `opus`, `vesu`, `unruggable`
- **Blockchain**: `erc20`, `erc721`, `transaction`, `starknet-rpc`, `contract`
- **Dev Tools**: `scarb`, `cairo-coder`
- **Special**: `artpeace`

## Development

### Build

```bash
pnpm install
pnpm build
```

The build process compiles TypeScript and copies resource files to the build directory.

## Architecture

This MCP is designed to be completely standalone with no blockchain dependencies. It uses:

- **Static resources**: Help guide, architecture docs, and capabilities are stored as markdown files in `src/resources/`
- **Static project ideas**: Curated list of project ideas
- **No external dependencies**: All data is bundled with the MCP for offline access

## License

MIT

## Support

- GitHub Issues: [Create an issue](https://github.com/kasarlabs/ask-starknet/issues)
- Documentation: [docs.kasar.io](https://docs.kasar.io)