# Consumer Rights Wiki MCP Server

A Model Context Protocol (MCP) server that provides access to the Consumer Rights Wiki, a platform documenting modern consumer exploitation issues.

## Overview

This MCP server enables AI assistants to interact with the Consumer Rights Wiki (https://consumerrights.wiki), which documents various forms of consumer exploitation including:

- Privacy violations and data misuse
- Dark patterns in user interfaces
- Forced arbitration clauses
- Ownership rights violations
- Deceptive pricing practices
- And more modern consumer issues

## Features

The server provides the following tools:

### 1. `search_wiki`
Search for articles in the Consumer Rights Wiki.
- **Parameters:**
  - `query` (required): Search terms
  - `limit` (optional): Number of results (default: 10, max: 50)

### 2. `get_page_content`
Retrieve the full content of a specific wiki page.
- **Parameters:**
  - `title` (required): The page title
  - `section` (optional): Specific section number to retrieve

### 3. `get_page_info`
Get metadata about a wiki page including revision history, categories, and protection status.
- **Parameters:**
  - `title` (required): The page title

### 4. `get_recent_changes`
View recent changes to the wiki.
- **Parameters:**
  - `limit` (optional): Number of changes to return (default: 10, max: 50)
  - `namespace` (optional): Filter by namespace (0 = main articles)

### 5. `get_categories`
List all categories or pages within a specific category.
- **Parameters:**
  - `category` (optional): Category name (without "Category:" prefix)
  - `limit` (optional): Number of results (default: 20, max: 50)

### 6. `get_page_sections`
Get the section structure of a wiki page.
- **Parameters:**
  - `title` (required): The page title

## Installation

1. Clone this repository or create a new directory:
```bash
mkdir consumer-rights-wiki-mcp
cd consumer-rights-wiki-mcp
```

2. Save the provided files:
   - `src/index.ts` (the main server code)
   - `package.json`
   - `tsconfig.json`

3. Install dependencies:
```bash
npm install
```

4. Build the TypeScript code:
```bash
npm run build
```

## Configuration

### For Claude Desktop

Add the following to your Claude Desktop configuration file:

**On macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**On Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "consumer-rights-wiki": {
      "command": "node",
      "args": ["path/to/consumer-rights-wiki-mcp/build/index.js"]
    }
  }
}
```

### For Other MCP Clients

The server runs on stdio transport. Start it with:
```bash
npm start
```

## Usage Examples

Once configured, you can ask your AI assistant to:

1. **Search for companies:**
   "Search the Consumer Rights Wiki for information about X Corp"

2. **Get detailed article content:**
   "Get the full content of the X Corp article from Consumer Rights Wiki"

3. **Browse recent changes:**
   "Show me the most recent changes to Consumer Rights Wiki"

4. **Explore categories:**
   "What categories are available in Consumer Rights Wiki?"
   "Show me all articles in the 'Privacy violations' category"

5. **Get page structure:**
   "What sections are in the 'Apple Inc.' article?"

## Development

For development with hot reloading:
```bash
npm run dev
```

To clean build artifacts:
```bash
npm run clean
```

## API Limitations

- The server uses the public MediaWiki API, which has rate limits
- Search results are limited to 50 per query
- Some content may require authentication for editing (not implemented in this version)

## Contributing

This MCP server is designed to help expose consumer exploitation practices. Consider contributing to:
- The Consumer Rights Wiki itself by documenting consumer issues
- This MCP server by adding new features or improving existing ones

## License

MIT License

## Related Resources

- [Consumer Rights Wiki](https://consumerrights.wiki)
- [Model Context Protocol Documentation](https://modelcontextprotocol.io)
- [MediaWiki API Documentation](https://www.mediawiki.org/wiki/API:Main_page)