gatecore-langchain

gatecore-langchain provides three LangChain tools for GateCore marketplace discovery and procurement, plus helpers that execute a procured capability through GateCore's signed gateway. The adapter contains transport and configuration only; GateCore services enforce identity, policy, trust, pricing, funding, delegation, and settlement.

The MCP tools support public full-mode GateCore endpoints only. read mode passes the server's fail-closed procurement error through unchanged. off mode is unsupported because it does not replace the adapter's legacy placeholder identity with the MCP credential identity.

Install from the GateCore monorepo

python -m pip install -e ./libs/sdk -e ./libs/adapters/gatecore-langchain

Install from PyPI

python -m pip install gatecore-langchain

Configuration

Discovery and procurement require:

GATECORE_MCP_URL=https://mcp.gatecoreai.com/mcp
GATECORE_MCP_KEY=gcmk_...

execute_procured and aexecute_procured validate these variables lazily on first use:

GATECORE_GATEWAY_URL=https://api.gatecoreai.com
GATECORE_BEARER_TOKEN=...
GATECORE_AGENT_ID=agent:example
GATECORE_ACCESS_GRANT_ID=grant:example
GATECORE_KEY_ID=key:example
GATECORE_PRIVATE_KEY_PATH=/secure/path/agent-key.pem

Set exactly one of GATECORE_PRIVATE_KEY_PATH or GATECORE_PRIVATE_KEY_PEM.

Quick start

Copy-paste complete. The only value to substitute is your MCP access key; a free Developer key (1,000 governed transactions a month, no card) is minted at app.gatecoreai.com/developer/portal.

import os

os.environ["GATECORE_MCP_URL"] = "https://mcp.gatecoreai.com/mcp"
os.environ["GATECORE_MCP_KEY"] = "gcmk_..."  # your key from the developer portal

from gatecore_langchain import GateCoreToolkit

tools = GateCoreToolkit().get_tools()
for tool in tools:
    print(tool.name, "-", tool.description.splitlines()[0])

Discovery and procurement run over these two variables alone. Executing a procured capability through the signed gateway uses execute_procured and the gateway variables below:

from gatecore_langchain import GateCoreToolkit, execute_procured

tools = GateCoreToolkit().get_tools()
procure_result = tools[2].invoke({"listing_id": "listing:example"})
decision = execute_procured(procure_result, {"query": "example"})

All tools are async-native through LangChain's async invocation methods. Their synchronous bridge uses asyncio.run() and therefore must not be called from a thread that already owns a running event loop; use ainvoke() in async applications.