# biz-journals-mcp

MCP server for generating Scopus ISSN boolean queries based on journal rankings.

## Supported Rankings

| System | Grades (highest to lowest) | Year |
|--------|---------------------------|------|
| ABDC   | A*, A, B, C               | 2022 |
| AJG    | 4*, 4, 3, 2, 1            | 2021 |
| FT50   | FT-50                     | 2016 |

## Installation

```bash
npm install -g biz-journals-mcp
```

## Configuration

Add to your Claude Desktop config (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "biz-journals": {
      "command": "npx",
      "args": ["-y", "biz-journals-mcp"]
    }
  }
}
```

## Tools

### generate_scopus_query

Generates a Scopus boolean query of ISSN numbers.

**Parameters:**
- `filters` - Array of ranking filters:
  - `system` - "abdc", "ajg", or "ft50"
  - `grade` - Target grade (e.g., "A*", "4*", "FT-50")
  - `operator` - "at_least" (default) or "exactly"
  - `fields` - Optional array of disciplines to filter by

**Example output:**
```
(ISSN(0001-4826) OR ISSN(0361-3682) OR ISSN(0165-4101) OR ISSN(0021-8456))
```

### list_grades

Lists available grades for a ranking system.

### list_fields

Lists available fields/disciplines for a ranking system.

## Example Queries

Get ABDC A-level or higher journals in Accounting:
```json
{
  "filters": [{
    "system": "abdc",
    "grade": "A",
    "operator": "at_least",
    "fields": ["Accounting"]
  }]
}
```

Combine rankings (ABDC A* OR AJG 4*):
```json
{
  "filters": [
    { "system": "abdc", "grade": "A*", "operator": "exactly" },
    { "system": "ajg", "grade": "4*", "operator": "exactly" }
  ]
}
```

## License

MIT