@opra-app/mcp v2.0.0

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:

{
  "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!

1. Clone the repository:

   git clone https://github.com/your-username/opra-mcp.git
   cd opra-mcp

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

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

5. Rebuild after making changes:

   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