KosmoKrator

productivity

Immigrant MCP Integration for Claude Agent SDK

Connect Immigrant to Claude Agent SDK 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 Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

Immigrant MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

{
  "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 Claude Agent SDK

Claude Agent SDK 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 Claude Agent SDKClient-level gateway setup.