@opra-app/mcp/README.md

MCP server for OPRA's business and discount data

# OPRA MCP Server

This is a Model Context Protocol (MCP) server implementation that provides access to OPRA's business and discount data. The server exposes various tools that allow your client of choice to interact with OPRA's data programmatically.

## Setup Instructions

1. Generate an API key at https://opra.no/profil

2. Configure Claude Desktop:
   - Open Claude Desktop
   - Go to Settings > Developer
   - Click "Edit Config"
   - Paste in the following config:
```json
{
  "mcpServers": {
    "opra": {
      "command": "npx",
      "args": [
        "-y", "@opra-app/mcp"
      ],
      "env": {
        "OPRA_API_KEY": "<your api key>",
      }
    }
  }
}

   ```

3. Restart Claude Desktop to apply the changes

## Usage

The MCP server provides quite a few tools for you to explore discounts, businesses, dicounts in a given city and a lot more.

Restart your Claude Desktop app, and start asking away!

<details>
<summary>If you're a developer, here's how to get started</summary>
## Local Development

1. Clone the repository:
   ```bash
   git clone https://github.com/your-username/opra-mcp.git
   cd opra-mcp
   ```

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

3. Build the project:
   ```bash
   npm run build
   ```

4. Make changes to the source code in the `src` directory

5. Rebuild after making changes:
   ```bash
   npm run build
   ```

## Project Structure

- `src/`: Source code directory
  - `tools/`: Individual tool implementations
  - `api.ts`: API client implementation
  - `env.ts`: Environment configuration
  - `index.ts`: Main entry point

## Dependencies

- `@modelcontextprotocol/sdk`: MCP SDK for implementing the protocol
- `zod`: Runtime type checking and validation

## License

MIT
</details>