gatecore-crewai

gatecore-crewai provides three CrewAI 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.

This package intentionally duplicates the small adapter configuration, execution, and transport modules. A shared adapter-core package is a future decision that waits until a third framework adapter establishes the common surface.

Install from the GateCore monorepo

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

Install from PyPI

python -m pip install gatecore-crewai

Read the ten-minute public guide.

Supports Python 3.10-3.13. Python 3.14 is not yet supported, pending upstream crewai.

Configuration

Discovery is keyless. discover_listings and get_listing are public reads on the GateCore MCP endpoint: they need no key and no account, only the endpoint URL:

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

Procurement needs a GateCore MCP access key (gcmk_...). procure, list_procurements, and submit_lead are rejected without one, because agent identity and tenant scope come from the credential. This adapter's gatecore_procure tool is the one that needs it:

GATECORE_MCP_KEY=gcmk_...

A key that is set but malformed fails at toolkit construction; a key that is absent is only an error when a tool that needs one is called.

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

Discovery is copy-paste complete and needs no key:

import os

os.environ["GATECORE_MCP_URL"] = "https://mcp.gatecoreai.com/mcp"

from gatecore_crewai import GateCoreToolkit

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

listings = tools[0].run(query="data")  # keyless
print(listings[0]["listing_id"])

Procurement is the step that needs a key. A free Developer key (1,000 governed transactions a month, no card) is minted at app.gatecoreai.com/developer/portal; set it as GATECORE_MCP_KEY before calling gatecore_procure.

Procurement runs over GATECORE_MCP_URL and GATECORE_MCP_KEY alone. Executing a procured capability through the signed gateway uses execute_procured and the gateway variables above:

from gatecore_crewai import GateCoreToolkit, execute_procured

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

CrewAI tools are sync-native. Their synchronous implementation uses asyncio.run() for the MCP transport and therefore must not be called from a thread that already owns a running event loop; use arun() in async applications.