Back to the catalog

1lev1

Track partnership work, log mission hours, and see what needs your approval on 1lev1.com.

Open source Repository Open in the app JSON README (API)

About

Track partnership work, log mission hours, and see what needs your approval on 1lev1.com.

Details

Kind
MCP servers
Topic
No topic detected
Publisher
avi-adam
Origin
official
Category
ferramentas
Transport
http
Version
1.0.0
Last push
2026-09-03T17:27:11Z
Repository state
ativo
Language
JavaScript
Added
2026-09-03 18:00:56
Updated
2026-09-03 18:00:56
Origin id
io.github.Avi-ADAM/1lev1

README

# 1lev1 MCP Setup ๐Ÿ’— (English)

A CLI tool to quickly connect the **1lev1** system to your favorite AI agents (Claude Desktop, Cursor, Windsurf, VS Code, etc.) using the MCP (Model Context Protocol).

## Features

By connecting, your AI agent gains "superpowers" within the 1lev1 system:

- ๐Ÿ•’ **Timer Control**: Start, stop, and manage timers in real-time.
- ๐Ÿค **Partnerships**: Manage and connect different entities in the system.
- โœ… **Task Management**: Automatically create and track tasks.
- ๐Ÿ“Š **Voting & Sales Data**: Get real-time updates on audience voting and sales reports.

## Installation & Usage

No prior installation is needed. Simply run:

```bash
npx 1lev1-mcp
```

This does two things:

1. **Connects** โ€” opens 1lev1.com, you log in and approve, and the API key is
   written into every AI agent you actually have installed.
2. **Installs the skill** โ€” the standing instructions that teach the agent what
   a rikma is, that logged hours are ownership, and that it must never vote or
   sign a profit-split on somebody else's behalf. The connection gives the agent
   hands; the skill gives it judgement.

Restart your agent afterwards to pick up the new config.

To undo everything:

```bash
npx 1lev1-mcp remove
```

That removes the server entry and the skill from every agent config. The API key
itself stays valid until you revoke it at **1lev1.com โ†’ Settings โ†’ API keys**.

### What it will not touch

- Config files that are not plain JSON (VS Code `settings.json` with comments,
  for example) are **left alone** and reported, never rewritten.
- Agents you have not installed are skipped โ€” no directories are created and no
  API key is written for a tool you do not use.
- Every file it does modify is backed up once to `<file>.1lev1.bak` first, and
  written atomically.

## Customization (for Developers)

To use this tool for your own MCP project, follow these two simple steps:

1. **Edit Config**: Change the values in `src/app-config.js` to match your service name and server URLs.
2. **Server-Side Implementation**: Ensure your website has the following routes:
   - `authUrlBase`: A page for authentication that returns the user to the callback URL with the API Key.
   - `mcpUrl`: The MCP server endpoint (supporting SSE or Stdio).

---

**1lev1 - we can together ๐Ÿ’—**

---

# 1lev1 MCP Setup (Hebrew) ๐Ÿ’—

ื›ืœื™ CLI ืœื—ื™ื‘ื•ืจ ืžื”ื™ืจ ืฉืœ ืžืขืจื›ืช **1lev1** ืœืกื•ื›ื ื™ ื”-AI ื”ืื”ื•ื‘ื™ื ืขืœื™ืš (Claude Desktop, Cursor, Windsurf, VS Code ื•ืขื•ื“) ื‘ืืžืฆืขื•ืช ืคืจื•ื˜ื•ืงื•ืœ MCP (Model Context Protocol).

## ืžื” ื–ื” ืžืืคืฉืจ?

ื‘ืืžืฆืขื•ืช ื”ื—ื™ื‘ื•ืจ, ืกื•ื›ืŸ ื”-AI ืฉืœืš ืžืงื‘ืœ ื™ื›ื•ืœื•ืช "ืขืœ" ื‘ืชื•ืš ื”ืžืขืจื›ืช ืฉืœ 1lev1:

- ๐Ÿ•’ **ืฉืœื™ื˜ื” ื‘ื˜ื™ื™ืžืจื™ื**: ื”ืคืขืœื”, ืขืฆื™ืจื” ื•ื ื™ื”ื•ืœ ื–ืžืŸ ื‘ื–ืžืŸ ืืžืช.
- ๐Ÿค **ื™ืฆื™ืจืช ืฉื•ืชืคื•ื™ื•ืช**: ื ื™ื”ื•ืœ ื•ื—ื™ื‘ื•ืจ ื’ื•ืจืžื™ื ืฉื•ื ื™ ื‘ืžืขืจื›ืช.
- โœ… **ื ื™ื”ื•ืœ ืžืฉื™ืžื•ืช**: ื™ืฆื™ืจื” ื•ืžืขืงื‘ ืื—ืจ ืžืฉื™ืžื•ืช ื‘ืฆื•ืจื” ืื•ื˜ื•ื‘ื˜ื™ืช.
- ๐Ÿ“Š **ื ืชื•ื ื™ ื”ืฆื‘ืขื•ืช ื•ืžื›ื™ืจื•ืช**: ืงื‘ืœืช ืžื™ื“ืข ืžืขื•ื“ื›ืŸ ืขืœ ื”ืฆื‘ืขื•ืช ืงื”ืœ ื•ื“ื•"ื—ื•ืช ืžื›ื™ืจื”.

## ื”ืชืงื ื” ื•ืฉื™ืžื•ืฉ

ื‘ืจื’ืข ืฉื”ื—ื‘ื™ืœื” ืžืคื•ืจืกืžืช ื‘-NPM, ืื™ืŸ ืฆื•ืจืš ื‘ื”ืชืงื ื” ืžื•ืงื“ืžืช. ืคืฉื•ื˜ ื”ืจื™ืฆื•:

```bash
npx 1lev1-mcp
```

## ื”ืชืืžื” ืื™ืฉื™ืช (ืœืžืคืชื—ื™ื)

ืื ื‘ืจืฆื•ื ืš ืœื”ืฉืชืžืฉ ื‘ื›ืœื™ ื–ื” ืขื‘ื•ืจ ืคืจื•ื™ืงื˜ MCP ืžืฉืœืš, ืขืœื™ืš ืœื‘ืฆืข ืฉื ื™ ืคืขื•ืœื•ืช ืคืฉื•ื˜ื•ืช:

1. **ืขืจื™ื›ืช ื”ืงื•ื ืคื™ื’**: ืฉื ื” ืืช ื”ืขืจื›ื™ื ื‘-`src/app-config.js` ื›ื“ื™ ืฉื™ืชืื™ืžื• ืœืฉื ื”ืฉื™ืจื•ืช ื•ืœื›ืชื•ื‘ื•ืช ื”-URL ืฉืœ ื”ืฉืจืช ืฉืœืš.
2. **ืžื™ืžื•ืฉ ื‘ืฆื“ ื”ืฉืจืช**: ืขืœื™ืš ืœื•ื•ื“ื ืฉื‘ืืชืจ ืฉืœืš ืงื™ื™ืžื™ื ื”ืจืื•ื˜ื™ื (Routes) ื”ื‘ืื™ื:
   - `authUrlBase`: ื“ืฃ ืฉืžื‘ืฆืข ืื™ืžื•ืช ื•ืžื—ื–ื™ืจ ืืช ื”ืžืฉืชืžืฉ ืœื›ืชื•ื‘ืช ื”-callback ืขื ื”-API Key.
   - `mcpUrl`: ื ืงื•ื“ืช ื”ืงืฆื” (Endpoint) ืฉืœ ืฉืจืช ื”-MCP ืฉืชื•ืžื›ืช ื‘-SSE ืื• ื‘-Stdio.

---

More