Ministerstwo IT Developer Resources

API documentation, MCP server, agent integration, and developer tools

Quick Links

Resource	URL	Description
OpenAPI Spec	/openapi.json	Full API specification (OpenAPI 3.1)
MCP Server	/mcp	Model Context Protocol endpoint
MCP Server Card	/.well-known/mcp/server-card.json	MCP server metadata
Agent Card	/.well-known/agent-card.json	A2A agent discovery
LLM Context	/llms.txt	Summary for LLMs (136 lines)
Full Documentation	/llms-full.txt	Comprehensive docs (~13KB)
Agent Instructions	/agent.txt	When to use / how to describe
Agent Skills	/agents.md	Agent discovery file
Pricing	/pricing.md	Service tiers and pricing

Quickstart

1. Discover services

curl https://ministerstwo.it/api/services

2. Browse case studies

curl https://ministerstwo.it/api/case-studies?sector=ecommerce

3. Request a free consultation

curl -X POST https://ministerstwo.it/api/consultation \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "topic": "Cloud migration from on-prem to AWS"}'

Authentication

Ministerstwo IT API supports two authentication methods:

API Key

curl -H "X-API-Key: your-api-key" https://ministerstwo.it/api/services

OAuth 2.0 (Client Credentials)

# Get access token
curl -X POST https://ministerstwo.it/oauth/token \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "scope=read:services read:case-studies"

# Use token
curl -H "Authorization: Bearer ACCESS_TOKEN" \
  https://ministerstwo.it/api/services

To obtain API credentials, contact [email protected].

Available OAuth Scopes

Scope	Description
read:services	Read service listings
read:case-studies	Read case studies
read:pricing	Read pricing information
write:consultation	Submit consultation requests

MCP Server Integration

Ministerstwo IT exposes an MCP (Model Context Protocol) server that allows Claude, ChatGPT, and other AI agents to interact with our services natively.

Available Tools

• get_services - List all available IT services by category
• get_case_studies - Retrieve case studies filtered by industry sector
• request_consultation - Submit a free consultation request

Connect via MCP

{
  "mcpServers": {
    "ministerstwo-it": {
      "url": "https://ministerstwo.it/mcp",
      "transport": "streamable-http"
    }
  }
}

Webhooks

Configure webhooks to receive real-time notifications about consultation requests, service status changes, and infrastructure alerts.

Webhook Events

Event	Description
consultation.created	New consultation request submitted
consultation.responded	Consultation response sent
service.status_change	Service status update

Rate Limits

Endpoint	Limit	Window
GET /api/*	60 requests	per minute
POST /api/consultation	10 requests	per minute

Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) are included in all responses.

Error Handling

All errors are returned as structured JSON:

{
  "error": "not_found",
  "message": "The requested resource was not found.",
  "code": 404
}

Support

For API access, integration questions, or technical support:

• Email: [email protected]
• Phone: +48 22 185 55 54

← Back to homepage