KosmoKrator

productivity

Immigrant MCP Integration for LangGraph

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

7 functions 6 read 1 write Bearer token auth

Connect Immigrant to LangGraph

Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions.

Use a graph node that calls the KosmoKrator CLI for deterministic steps or an MCP client for dynamic tool selection. The gateway is local, scoped to this integration, and starts with --write=deny so LangGraph can inspect read-capable tools without receiving write access by default.

Immigrant MCP Config for LangGraph

Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.

{
  "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 LangGraph

LangGraph 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