autoform-mcp 0.1.0

MCP server for the Autoform API from Slovensko.Digital

Autoform MCP Server

Model Context Protocol (MCP) server for the Autoform service from Slovensko.Digital based on the API documentation.

Author: @alhafoudh

Features

• Search Slovak corporate bodies (companies, organizations) by name
• Search by registration number (IČO/CIN)
• Filter results to show only active (non-terminated) entities
• Returns detailed company information including addresses and tax IDs

Installation

# Clone the repository
git clone https://github.com/alhafoudh/autoform-mcp.git
cd autoform-mcp

# Install dependencies
uv sync

Configuration

Set the AUTOFORM_PRIVATE_ACCESS_TOKEN environment variable with your API token from Slovensko.Digital.

export AUTOFORM_PRIVATE_ACCESS_TOKEN="your-token-here"

Usage

Run the MCP server (STDIO transport)

uv run python autoform_mcp.py

Run with FastMCP CLI

uv run fastmcp run autoform_mcp.py

Inspect available tools

uv run fastmcp inspect autoform_mcp.py

Development mode with MCP Inspector

uv run fastmcp dev autoform_mcp.py

Available Tools

query_corporate_bodies

Search Slovak corporate bodies using a query expression.

Parameters:

• query (string, required): Query expression in format field:value
• limit (integer, optional): Maximum number of results (1-20, default 5)
• active_only (boolean, optional): If true, return only active entities

Query format:

• name:<value> - Search by company name prefix
• cin:<value> - Search by IČO (registration number) prefix

Examples:

query_corporate_bodies(query="name:Slovenská pošta")  # Find companies starting with "Slovenská pošta"
query_corporate_bodies(query="cin:36631124")          # Find company with IČO 36631124
query_corporate_bodies(query="cin:366", limit=10)     # Find companies with IČO starting with "366"
query_corporate_bodies(query="name:Test", active_only=True)  # Only active companies

Available Resources

autoform://api-info

Returns information about the Autoform API and this MCP server.

Claude Code Integration

Using uvx (recommended)

Run the server directly from PyPI without installation:

claude mcp add autoform -e AUTOFORM_PRIVATE_ACCESS_TOKEN=your-token-here -- uvx autoform-mcp

Using local installation

If you've cloned the repository:

claude mcp add autoform -e AUTOFORM_PRIVATE_ACCESS_TOKEN=your-token-here -- uv run python /path/to/autoform_mcp.py

Claude Desktop Integration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

Using uvx (recommended)

{
  "mcpServers": {
    "autoform": {
      "command": "uvx",
      "args": ["autoform-mcp"],
      "env": {
        "AUTOFORM_PRIVATE_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

Using local installation

{
  "mcpServers": {
    "autoform": {
      "command": "uv",
      "args": ["run", "python", "/path/to/autoform-mcp.py"],
      "env": {
        "AUTOFORM_PRIVATE_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

Development

Install dev dependencies

uv sync --all-extras

Run tests

uv run pytest -v

License

MIT