langchain-bosco

LangChain tools for Bosco Labs: answers from official records (company registers, SEC EDGAR, sanctions lists, EU and national law, ECB and Eurostat), each row with its source URL.

pip install langchain-bosco

from langchain.agents import create_agent
from langchain_bosco import CounterpartyCheckTool, PlanOfficialRecordsQueryTool

agent = create_agent(
    "openai:gpt-5-mini",
    tools=[CounterpartyCheckTool(), PlanOfficialRecordsQueryTool()],  # key: BOSCO_API_KEY
)
result = agent.invoke(
    {"messages": [{"role": "user", "content": "Can we pay Novo Nordisk (CVR 24256790)?"}]}
)
print(result["messages"][-1].content)

Tools

from langchain_bosco import BoscoToolkit

tools = BoscoToolkit().get_tools()  # one HTTP call to the free catalogue

Auth

Paid tools need a Bosco Labs API key (prepaid credits): get one at https://boscolabs.dev/api.html and set BOSCO_API_KEY, or pass api_key=... to a tool or the toolkit. Every tool and the toolkit also take base_url. The planner needs no key.

API errors (bad input, no credits, a source down) come back to the model as text (handle_tool_error=True); run_bosco_tool raises ToolException. Nothing is charged on an error.

Docs: https://boscolabs.dev/llms.txt - OpenAPI: https://api.boscolabs.dev/openapi.json - support: support@boscolabs.dev

The counterparty check is a screening aid, not a compliance, credit or legal determination: review every fail and review before acting.

Development

uv run --isolated --with-editable . --with pytest pytest -q