@cyanheads/openfec-mcp-server 0.2.2 → 0.2.3

package/CLAUDE.md

@@ -1,7 +1,7 @@
 # Agent Protocol
 
 **Server:** openfec-mcp-server
-**Version:** 0.2.2
+**Version:** 0.2.3
 **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)
 
 > **Read the framework docs first:** `node_modules/@cyanheads/mcp-ts-core/CLAUDE.md` contains the full API reference — builders, Context, error codes, exports, patterns. This file covers server-specific conventions only.

package/README.md

@@ -6,12 +6,18 @@
 
 <div align="center">
 
-[![Version](https://img.shields.io/badge/Version-0.2.2-blue.svg?style=flat-square)](./CHANGELOG.md) [![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-259?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) 
+[![npm](https://img.shields.io/npm/v/@cyanheads/openfec-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/openfec-mcp-server) [![Version](https://img.shields.io/badge/Version-0.2.3-blue.svg?style=flat-square)](./CHANGELOG.md) [![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-259?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) 
 
 [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-^1.2.0-f9f1e1.svg?style=flat-square)](https://bun.sh/)
 
 </div>
 
+<div align="center">
+
+**Public Hosted Server:** [https://openfec.caseyjhand.com/mcp](https://openfec.caseyjhand.com/mcp)
+
+</div>
+
 ---
 
 ## Tools
@@ -169,6 +175,62 @@ OpenFEC-specific:
 
 ## Getting Started
 
+### Public Hosted Instance
+
+A public instance is available at `https://openfec.caseyjhand.com/mcp` — no installation required. Point any MCP client at it via Streamable HTTP:
+
+```json
+{
+  "mcpServers": {
+    "openfec": {
+      "type": "streamable-http",
+      "url": "https://openfec.caseyjhand.com/mcp"
+    }
+  }
+}
+```
+
+### Self-Hosted / Local
+
+Add the following to your MCP client configuration file.
+
+```json
+{
+  "mcpServers": {
+    "openfec": {
+      "type": "stdio",
+      "command": "bunx",
+      "args": ["@cyanheads/openfec-mcp-server@latest"],
+      "env": {
+        "MCP_TRANSPORT_TYPE": "stdio",
+        "FEC_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+Or with Docker:
+
+```json
+{
+  "mcpServers": {
+    "openfec": {
+      "type": "stdio",
+      "command": "docker",
+      "args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT_TYPE=stdio", "-e", "FEC_API_KEY=your-api-key", "ghcr.io/cyanheads/openfec-mcp-server:latest"]
+    }
+  }
+}
+```
+
+For Streamable HTTP, set the transport and start the server:
+
+```sh
+MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 FEC_API_KEY=your-key bun run start:http
+# Server listens at http://localhost:3010/mcp
+```
+
 ### Prerequisites
 
 - [Bun v1.2.0](https://bun.sh/) or higher
@@ -177,44 +239,21 @@ OpenFEC-specific:
 ### Installation
 
 1. **Clone the repository:**
+
 ```sh
 git clone https://github.com/cyanheads/openfec-mcp-server.git
 ```
 
 2. **Navigate into the directory:**
+
 ```sh
 cd openfec-mcp-server
 ```
 
 3. **Install dependencies:**
-```sh
-bun install
-```
 
-4. **Set up environment:**
 ```sh
-cp .env.example .env
-# Edit .env and add your FEC_API_KEY
-```
-
-### MCP Client Configuration
-
-Add to your MCP client config (e.g., `claude_desktop_config.json`):
-
-```json
-{
-  "mcpServers": {
-    "openfec": {
-      "type": "stdio",
-      "command": "bun",
-      "args": ["run", "start:stdio"],
-      "cwd": "/path/to/openfec-mcp-server",
-      "env": {
-        "FEC_API_KEY": "your-api-key"
-      }
-    }
-  }
-}
+bun install
 ```
 
 ## Configuration
@@ -255,13 +294,6 @@ Add to your MCP client config (e.g., `claude_desktop_config.json`):
   bun run test         # Runs test suite
   ```
 
-### Docker
-
-```sh
-docker build -t openfec-mcp-server .
-docker run -e FEC_API_KEY=your-key -p 3010:3010 openfec-mcp-server
-```
-
 ## Project Structure
 
 | Directory | Purpose |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyanheads/openfec-mcp-server",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "mcpName": "io.github.cyanheads/openfec-mcp-server",
   "description": "Access FEC campaign finance data through MCP. Query data about candidates, money trails, and election filings. STDIO & Streamable HTTP.",
   "type": "module",

package/server.json

@@ -1,19 +1,25 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.cyanheads/openfec-mcp-server",
-  "description": "Access FEC campaign finance data through MCP. Query data about candidates, money trails, and election filings. STDIO & Streamable HTTP.",
+  "description": "Access FEC campaign finance data. Query data about candidates, money trails, and election filings.",
   "repository": {
     "url": "https://github.com/cyanheads/openfec-mcp-server",
     "source": "github"
   },
-  "version": "0.2.2",
+  "version": "0.2.3",
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://openfec.caseyjhand.com/mcp"
+    }
+  ],
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/openfec-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.2.2",
+      "version": "0.2.3",
       "packageArguments": [
         { "type": "positional", "value": "run" },
         { "type": "positional", "value": "start:stdio" }
@@ -40,7 +46,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/openfec-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.2.2",
+      "version": "0.2.3",
       "packageArguments": [
         { "type": "positional", "value": "run" },
         { "type": "positional", "value": "start:http" }