langchain-fokals

LangChain tools for Fokals.

AI-powered company intelligence on how companies around the world grow, change and compete. Fokals derives advanced signals from company data, covering everything from technology and hiring to funding, buying intent and company health. Refreshed every day and brought together into a clear view of every market.

This package gives a LangChain agent that data as tools: find companies by what they show, enrich a list of accounts, profile one company in depth, follow what changed, and size a market.

Install

pip install -U langchain-fokals

Get a key

Sign up at fokals.com and make a key on your account page. Then set it:

export FOKALS_API_KEY="your-key"

Or pass it to a tool or the toolkit as fokals_api_key.

Use it in an agent

With langchain and a model package installed (pip install -U langchain langchain-anthropic):

from langchain.agents import create_agent
from langchain_fokals import FokalsToolkit

tools = FokalsToolkit().get_tools()
agent = create_agent("anthropic:claude-sonnet-5-5", tools)

result = agent.invoke({"messages": [{"role": "user", "content": "Which US companies running HubSpot are hiring now?"}]})
print(result["messages"][-1].content)

To give the agent only some tools, name them:

tools = FokalsToolkit(include=["find_companies", "company_profile", "count_companies"]).get_tools()

Call a tool directly

from langchain_fokals import FokalsCompanyProfile

profile = FokalsCompanyProfile()
print(profile.invoke({"company": "stripe.com", "sections": ["technology", "hiring"]}))

Each tool returns the API's own sentence about what it did, followed by the data as JSON. Called with a tool call, the data is also the tool message's artifact.

Tools

Prices

Paid tools are charged from your prepaid Fokals balance at the prices on the pricing page, also at api.fokals.com/v1/prices. A company that is not found costs nothing.

A call that would cost more than your account lets run unasked does not run. It returns its price instead, and the tool passes that on to the agent: the agent tells the person, and when they agree it calls again with max_usd. This is a normal answer, not an error.

Errors

A refused call (a bad argument, a key that is not valid, too many calls in a minute) reaches the agent as an error tool message in the API's own words, so the agent can correct itself. Set handle_tool_error=False on a tool to raise ToolException instead.

Prefer MCP?

Fokals is also a remote MCP server at https://mcp.fokals.com/mcp, with the same account, balance and prices. Use it from LangChain with langchain-mcp-adapters. See fokals.com/docs/connect.

Development

The tools are written from the API's own OpenAPI document, so their names, descriptions and arguments match the API:

python scripts/generate.py

Tests:

pip install -e . --group test
pytest tests/unit_tests --disable-socket --allow-unix-socket
FOKALS_API_KEY=your-key pytest tests/integration_tests   # free tools only

Licence

MIT