Biztoc

Provides access to Biztoc data sources and actions via a stdio MCP server with API key authentication.

python

0

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "bach-ai-tools-bachai-biztoc": {
      "command": "uvx",
      "args": [
        "--from",
        "bach-biztoc",
        "bach_biztoc"
      ],
      "env": {
        "API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

This Biztoc MCP Server provides programmatic access to the Biztoc API using a stdio-based MCP server. It lets you query sources, topics, latest news, and perform searches from your applications with secure API key authentication.

How to use

You use this MCP server by running it through an MCP client or platform that supports stdio connections. The server expects an API key to authorize requests, which you supply via environment variables. In your client, point to the local stdio MCP configuration and start the server as described. You can then query endpoints such as sources, news topics, latest news, and search to integrate Biztoc data into your app.

How to install

Prerequisites you need before installing:
- Python installed on your machine
- pip available for installing Python packages
- An MCP client or runtime that supports stdio servers (e.g., uvx) if you plan to use the recommended launcher

Installation steps:
1. Install the Biztoc MCP package from PyPI
2. Start the MCP server through the launcher or directly with Python in development mode if needed

Configuration and usage details

Authentication requires an API key. Set the environment variable API_KEY to your Biztoc API key before starting the MCP server.

Cursor users can configure the MCP connection with the following file. Replace YOUR_API_KEY_HERE with your actual API key.

{
  "mcpServers": {
    "bach-biztoc": {
      "command": "uvx",
      "args": ["--from", "bach-biztoc", "bach_biztoc"],
      "env": {
        "API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

How to run from development or via uvx

Run the MCP server using uvx, which will automatically install and run the server if you pass the package name as shown below.

uvx --from bach-biztoc bach_biztoc

How to run directly (development mode)

If you prefer to run the server directly in development mode, use Python to start the server script.

python server.py

Running after installation as a command

If you install the package, you can also run the MCP server using the package's command name after installation.

# Install the package
pip install bach-biztoc

# Run the MCP server (command name uses underscore)
bach_biztoc

Available tools

news__source

Get the latest news stories for the specified source_id in chronological order via GET /news/source/{source_id}.

sources

List all available source_ids via GET /sources and provide blocks like the main biztoc sources view.

news__topics

Get trending topic clusters and their stories via GET /news/topics, updated hourly.

search

Search the news index across the last 14 days via GET /search with query parameter q.

news__latest

Get the latest news stories in chronological order via GET /news/latest.