# Diavgeia Mcp Server

> MCP server from michalisKout/diavgeia-mcp-server.

- **Type:** MCP server
- **Install:** `agentstack add mcp-michaliskout-diavgeia-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [michalisKout](https://agentstack.voostack.com/s/michaliskout)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [michalisKout](https://github.com/michalisKout)
- **Source:** https://github.com/michalisKout/diavgeia-mcp-server

## Install

```sh
agentstack add mcp-michaliskout-diavgeia-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Diavgeia MCP Server

A Model Context Protocol (MCP) server that provides access to Greek government transparency data from the [Diavgeia platform](https://diavgeia.gov.gr/). This server enables AI assistants like Claude to search and retrieve Greek government decisions, making public administration data more accessible.

## 🌟 Features

- **Search Government Decisions**: Query decisions by keywords, date ranges, organization, and type

  

[MCP demo 📹](https://collection.cloudinary.com/dvyxq82nf/14ce145828a77c3312b4c4a94b3a4085)

- **Retrieve Decision Details**: Get comprehensive information about specific decisions using their ADA (unique identifier)

[MCP demo📹](https://collection.cloudinary.com/dvyxq82nf/2c240ecf9fb4d899ad81f11b5a2f4b34)

- **Date-aware Queries**: Natural language date parsing (e.g., "last year", "January 2024")
- **Organization Search**: Find decisions by ministry or government organization

## 🚀 Quick Start

### Local Development

1. **Clone the repository**
   ```bash
   git clone https://github.com/michalisKout/diavgeia-mcp-server.git
   cd diavgeia-mcp-server
   ```

2. **Install dependencies**
   ```bash
   pnpm install
   ```

3a. **Start development server**
   ```bash
   pnpm dev
   ```
  Your MCP server will be available at `http://localhost:8787/sse`

4a. **Use mcp inspector**
  More info: https://modelcontextprotocol.io/docs/tools/inspector

3b. **Start development server**
   ```bash
   pnpm build:local
   ```
  Run locally using stdio transport protocol:

  ```bash
  node /Users/michaliskoutridis/dev/projects/ai-agents/diavgeia-mcp-server/dist/local.js
  ```

See [mcp-config-schema.json](./mcp-config-schema.json) for the full configuration schema.

## 🛠 Available Tools

The Diavgeia MCP Server provides two main tools for accessing Greek government transparency data:

1. **`search-decisions`** - Search for government decisions with various filters
2. **`get-decision`** - Retrieve detailed information about a specific decision

For detailed documentation on all available tools, parameters, examples, and best practices, see **[docs/TOOLS.md](docs/TOOLS.md)**.

### Quick Examples

**Search for education decisions in 2024:**
```typescript
{
  "q": "εκπαίδευση",
  "from_date": "2024-01-01",
  "to_date": "2024-12-31"
}
```

**Get details for a specific decision:**
```typescript
{
  "ada": "ΨΧ465Κ8Ω-123"
}
```

## 📚 Documentation

- **[Tools Reference](docs/TOOLS.md)** - Complete tools documentation
- **[Security Guide](SECURITY.md)** - Security policy and vulnerability reporting
- **[Contributing Guidelines](CONTRIBUTING.md)** - How to contribute

## 🏗 Project Structure

```
src/
├── index.ts                 # Main MCP server entry point
├── api/
│   └── diavgeia.ts         # Diavgeia API client
├── modules/
│   ├── decision/           # Decision retrieval tool
│   │   ├── constants.ts
│   │   ├── schema.ts
│   │   └── tool.ts
│   └── search/             # Decision search tool
│       ├── constants.ts
│       ├── schema.ts
│       └── tool.ts
├── types/
│   └── diavgeia.ts         # TypeScript type definitions
├── utils/                  # Utility functions
└── prompts/
    └── template.ts         # System prompts
```

## 🔧 Development

### Prerequisites

- Node.js 23+ 
- pnpm package manager

## 🤝 Contributing

We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.

### Quick Contribution Steps

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Make your changes
4. Run tests and linting (`pnpm lint:fix && pnpm type-check`)
5. Commit your changes following conventional commits
6. Push to the branch (`git push origin feature/amazing-feature`)
7. Open a Pull Request

### Development Setup

```bash
# Install dependencies
pnpm install

# This will automatically set up git hooks via lefthook
# The hooks will:
# - Lint and format code on pre-commit
# - Validate commit messages
# - Run checks before push
```

### Commit Message Convention

This project uses [Conventional Commits](https://www.conventionalcommits.org/). All commit messages are validated automatically.

Examples:
```bash
git commit -m "feat: add new search filter"
git commit -m "fix: resolve date parsing bug"
git commit -m "docs: update api documentation"
```

See [Commit Conventions](.github/COMMIT_CONVENTION.md) for detailed guidelines.

### Restricted: Deploying

Contributors CANNOT deploy because:
1. They don't have `CLOUDFLARE_API_TOKEN`
2. They aren't logged in as the owner
3. They don't have permissions to do so

## Setting Up Your Own Deployment

If someone wants to deploy their OWN instance:

### 1. Create Cloudflare Account
- Sign up at https://dash.cloudflare.com/sign-up
- Free tier is available

### 2. Get Your Account ID
```bash
npx wrangler login
npx wrangler whoami
```

### 3. Update wrangler.jsonc (Optional)
If deploying to their own account, they should update:
```jsonc
{
  "name": "their-own-server-name",  // Change this
  // account_id will be read from their login
}
```

### 4. Deploy
```bash
npx wrangler login  // Authenticate
pnpm deploy         // Deploy to THEIR account
```

### 5a. Cloudflare AI Playground

1. Go to [Cloudflare AI Playground](https://playground.ai.cloudflare.com/)
2. Enter your deployed MCP server URL: `your-deployment.workers.dev/sse`
3. Start using the Diavgeia tools directly in the playground!

### 5b. Claude Desktop Integration

To connect this MCP server to Claude Desktop, add the following to your Claude Desktop configuration:

```json
{
  "mcpServers": {
    "diavgeia": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-deployment.workers.dev/sse"
      ]
    }
  }
}
```

## �📝 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

### Running Checks Locally

Before opening a PR, you can run checks locally:

```bash
# Type check
pnpm run check

# Lint
pnpm run lint

# Build
pnpm run build:local

```

## 🙏 Tools and APIs used

- [Diavgeia Platform](https://diavgeia.gov.gr/) - Greek Government Transparency Initiative
- [Model Context Protocol](https://modelcontextprotocol.io/) - Standard for AI tool integration
- [Cloudflare Workers](https://workers.cloudflare.com/) - Serverless deployment platform
- [Smithery](https://smithery.ai/) - Smithery mcp servers hosting

## 📬 Support

- 🐛 **Bug Reports**: [Open an issue](https://github.com/michalisKout/diavgeia-mcp-server/issues)
- 💡 **Feature Requests**: [Start a discussion](https://github.com/michalisKout/diavgeia-mcp-server/discussions)

---

Made with ❤️ for transparency in Greek governance

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [michalisKout](https://github.com/michalisKout)
- **Source:** [michalisKout/diavgeia-mcp-server](https://github.com/michalisKout/diavgeia-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-michaliskout-diavgeia-mcp-server
- Seller: https://agentstack.voostack.com/s/michaliskout
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.