Stats Daily

Stats Daily is a web application designed to help users track their daily tasks, set targets, and evaluate their work performance. By visualizing their progress and statistics, users can gain insights into their productivity and make necessary changes to improve.

Table of Contents

• Features
• MCP & API Access
• Installation
• Contributing
• License

Features

• User authentication
• Daily task input and tracking
• Visualization of task completion statistics
• Clean and user-friendly interface
• API Key management (create, revoke, scope-based access)
• MCP-compatible context endpoint for AI agents
• Secure, scoped, and revocable access

MCP & API Access

Stats Daily exposes a MCP context API that allows users to connect their data to AI agents (Claude, Cursor, custom agents, etc.).

MCP Scopes & Permissions

API keys use scopes to control what MCP clients are allowed to access. Each MCP endpoint validates scopes before processing the request.

Available Scopes

Areas

• mcp:areas:read – Read areas and its tasks and note

Achievements

• mcp:achievements:read – Read achievements
• mcp:achievements:write – Create achievements

Scope Enforcement

• Read endpoints require the corresponding :read scope
• Write endpoints require the corresponding :write scope
• Requests without the required scope return 403 Forbidden

Example

To allow an MCP client to read context and add achievements, assign:

["mcp:areas:read", "mcp:achievements:read", "mcp:achievements:write"]

Scopes can be updated at any time from the API Keys → Permissions settings for each API Key.

---

Authentication

All MCP requests are authenticated using Bearer API keys.

Authorization: Bearer <API_KEY>

---

MCP Context Endpoint

GET /api/mcp/context

Returns all areas with tasks for the authenticated user.

---

MCP Achievements Endpoints

GET /api/mcp/achievements?date=YYYY-MM-DD

Returns all achievements and note for the authenticated user on the specified date.

POST /api/mcp/achievements

Request body:

{
  "text": "Achievement text",
  "note": "Added note with it" // Optional
}

Adds a new achievement for the authenticated user.

---

MCP Server (@snvshal/sndo)

Stats Daily provides an official Model Context Protocol (MCP) server that allows AI agents to securely access a user’s tasks and notes using API keys.

Package

npx @snvshal/sndo

This MCP server communicates over stdio and is compatible with MCP-enabled clients such as Claude, Cursor, and custom agents.

---

Setting Up MCP Access

1. Create an API Key

• Go to API Keys
• Create a new key

2. Configure Your MCP Client

Set your API key as an environment variable:

export SNDO_API_KEY=your_api_key_here

Or provide it directly in your MCP client configuration.

3. Example MCP Client Configuration

{
  "mcpServers": {
    "sndo": {
      "command": "npx",
      "args": ["@snvshal/sndo"],
      "env": {
        "SNDO_API_KEY": "your_api_key_here"
      }
    }
  }
}

What Data Is Exposed

• Areas
• Tasks
• Notes
• Last updated timestamps

Access is read-only, scoped, and can be revoked at any time.

---

Installation

To get started with the project, follow these steps:

1. Clone the repository:

   git clone https://github.com/snvshal/stats-daily.git
   
   cd stats-daily

2. Install dependencies:

   npm install

3. Run the development server:

   npm run dev

The application will be available at http://localhost:3000.

---

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any changes or improvements.

• Fork the repository
• Create a new branch

  git checkout -b feature-branch

• Commit your changes

  git commit -m 'Add new feature'

• Push to the branch

  git push origin feature-branch

• Open a pull request

---

License

MIT