KosmoKrator

productivity

Immigrant MCP Integration for Generic MCP Clients

Connect Immigrant to Generic MCP Clients through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 6 read 1 write Bearer token auth
Submit Immigrant feedback View package source

Connect Immigrant to Generic MCP Clients

Connect any stdio-compatible MCP client to local KosmoKrator integration tools.

Register kosmo mcp:serve as the command for a local stdio MCP server. The gateway is local, scoped to this integration, and starts with --write=deny so MCP clients can inspect read-capable tools without receiving write access by default.

Immigrant MCP Config for Generic MCP Clients

Start with read-only write policy and expand only for trusted projects.

{
  "mcpServers": {
    "kosmokrator-immigrant": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=immigrant",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=immigrant --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Immigrant instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Immigrant Tools Visible to MCP clients

MCP clients sees stable MCP tool names generated from the Immigrant integration catalog.

MCP toolSource functionTypeDescription
integration__immigrant__immigrant_list_applications immigrant.immigrant_list_applications Read List immigration applications. Returns a paginated list of applications, optionally filtered by status.
integration__immigrant__immigrant_get_application immigrant.immigrant_get_application Read Get details of a specific immigration application by its ID.
integration__immigrant__immigrant_create_application immigrant.immigrant_create_application Write Create a new immigration application. Requires a type and applicant name. Optionally provide additional details.
integration__immigrant__immigrant_list_documents immigrant.immigrant_list_documents Read List documents for a specific immigration application. Returns a paginated list of documents.
integration__immigrant__immigrant_get_document immigrant.immigrant_get_document Read Get details of a specific document by its ID.
integration__immigrant__immigrant_list_statuses immigrant.immigrant_list_statuses Read List all available immigration application statuses. Use this to understand valid status values for filtering.
integration__immigrant__immigrant_get_current_user immigrant.immigrant_get_current_user Read Get the profile of the currently authenticated Immigrant user. Use this to verify credentials and see user details.

Related Immigrant Pages

Immigrant CLIUse direct JSON commands instead of MCP discovery. Immigrant MCPFull gateway reference and MCP tool names. KosmoKrator for MCP clientsClient-level gateway setup.