# @agentskills/mcp-server

MCP (Model Context Protocol) server for [AgentSkills API](https://agentskills.io). Gives Claude, Cursor, and other AI tools access to web search, code review, and Korean business data.

## Quick Start

### 1. Get an API key

Sign up for free at [agentskills.io](https://agentskills.io) — no credit card required, 100 free calls/month.

### 2. Add to Claude Desktop

Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "agentskills": {
      "command": "npx",
      "args": ["-y", "@gpters/agentskills-mcp"],
      "env": {
        "AGENTSKILLS_API_KEY": "sk_your_key_here"
      }
    }
  }
}
```

Restart Claude Desktop and you're done.

### 3. Add to Claude Code

```bash
claude mcp add agentskills -- npx -y @gpters/agentskills-mcp
```

Then set your API key:

```bash
export AGENTSKILLS_API_KEY=sk_your_key_here
```

Or add it to your shell profile (`~/.zshrc`, `~/.bashrc`).

### 4. Add to Cursor

Open Settings → MCP and add:

```json
{
  "agentskills": {
    "command": "npx",
    "args": ["-y", "@gpters/agentskills-mcp"],
    "env": {
      "AGENTSKILLS_API_KEY": "sk_your_key_here"
    }
  }
}
```

---

## Available Tools

### `web_search`

Real-time web search with structured results and AI summary.

**Parameters:**
- `query` (required) — search query
- `maxResults` — number of results (default: 5)
- `language` — `"ko"` or `"en"` (default: `"ko"`)

**Example:**
> "Search for the latest news about Samsung Electronics"

---

### `code_review`

Analyzes code for bugs, security issues, and improvement suggestions.

**Parameters:**
- `code` (required) — source code (max 50,000 chars)
- `language` — programming language (optional, auto-detected)
- `focus` — `"security"`, `"performance"`, `"quality"`, or `"all"` (default)

**Example:**
> "Review this TypeScript file for security issues"

---

### `business_data`

Korean company information, news, and financial data.

**Parameters:**
- `type` (required) — `"company-info"`, `"news"`, or `"financial"`
- `companyName` — company name in Korean or English
- `businessNumber` — Korean business registration number (사업자등록번호)

**Example:**
> "Look up company info for 삼성전자"

---

## Pricing

| Plan       | Monthly calls | Price        |
|------------|--------------|--------------|
| Free       | 100          | ₩0           |
| Pro        | 10,000       | ₩49,000/mo   |
| Enterprise | Unlimited    | Contact us   |

---

## License

MIT