Tool Connector

An MCP server that gives an LLM host (e.g. Claude) two tools: it can search the firm's documents and look up a company via an authenticated API the "connect frontier models to our files and data, with auth" use case.

Demo

Register the server with Claude Desktop, then ask Claude something that triggers search_documents, and something that triggers lookup_company.

What it does

Exposes two tools over the Model Context Protocol:

• search_documents(query, k) — makes a document folder query-able (no auth).
• lookup_company(name) — calls an authenticated external API (bearer token), making the API + authentication path explicit.

Authentication (done on purpose)

lookup_company reads DATA_API_TOKEN from the environment (never hardcoded) and returns a clear "authentication required" message when it is absent rather than failing silently. Use a scoped, read-only token; full OAuth is the production step.

Run it

pip install -r requirements.txt
pytest -q                      # tools work + both register with the MCP server
python server.py               # run as an MCP (stdio) server

Then add it to Claude Desktop using claude_desktop_config.example.json (use an absolute path to server.py). Confirm the exact MCP SDK usage against the current docs at modelcontextprotocol.io.

Built with

Python · MCP Python SDK (FastMCP) · httpx