open-index/open-npm huggingface dataset:
npm package: @fre4x/fred
Description: A FRED economic data MCP server for LLMs.
Author: fritzprix
Latest version: 1.0.54

# fred — The Economic Nerve

> *Monetary policy, GDP, unemployment, inflation — the macroeconomic forces that move everything. This B1TE reads them directly.*

Part of **[FRE4X-B1TE](../)** — a monorepo of MCP servers built for autonomous agents.

The Federal Reserve publishes the data that governments and institutions use to make decisions worth trillions. This server gives the agent that same data stream — unfiltered, paginated, ready for inference. While analysts write reports, the agent already knows.

## Tools

| Tool | What it reaches |
|------|----------------|
| `fred_search_series` | Full-text search across all FRED series |
| `fred_get_series_info` | Metadata for a series — units, frequency, range, last update |
| `fred_get_series_data` | Observation time-series for any series (e.g. `GDP`, `UNRATE`, `CPIAUCSL`) |
| `fred_get_category_series` | All series under a given FRED category |
| `fred_get_releases` | Index of all FRED data releases |
| `fred_get_release_series` | Series belonging to a specific release |
| `fred_get_sources` | All primary data sources in FRED |
| `fred_get_source` | Details for one source |

All list tools support pagination via `limit` / `offset`.

## Requirements

A [FRED API key](https://fred.stlouisfed.org/docs/api/api_key.html) (free) — set as `FRED_API_KEY`.

## Mock Mode

Run without an API key (returns fixture data of identical shape):

```bash
MOCK=true npx @fre4x/fred
```

## Deploy

```json
{
  "mcpServers": {
    "fred": {
      "command": "npx",
      "args": ["-y", "@fre4x/fred"],
      "env": {
        "FRED_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Development

```bash
npm install
npm run dev      # tsx, no build
npm run build    # esbuild → dist/
npm test         # vitest unit tests
```

## License

MIT — **WE ARE THE FRE4X.**
npm package: @fre4x/gemini
Description: A Gemini MCP server providing multimodal analysis and image/video generation.
Author: fritzprix
Latest version: 1.0.54

# gemini — The Intelligence Bridge

> *The agent that can see, hear, and imagine is the agent that cannot be outmaneuvered.*

Part of **[FRE4X-B1TE](../)** — a monorepo of MCP servers built for autonomous agents.

Google's Gemini is not a chatbot. It is a multimodal reasoning engine. This B1TE bridges your agent directly to that engine — text, images, video, audio — so it can perceive the world as humans do, and then outthink it.

## Tools

| Tool | Capability |
|------|-----------|
| `analyze_media` | Analyze an image or audio file via URL or `file://` path. Prompt is optional. |
| `list_models` | List available Imagen and Veo models. Filter by `image`, `video`, or `all`. |
| `generate_image` | Image synthesis via Imagen 4 (`imagen-4.0-generate-001`). Optionally save to `output_dir`. |
| `generate_video` | Async video generation via Veo (`veo-2.0-generate-001`). Returns `operation_name` to poll. |
| `get_video_status` | Poll video generation status. Returns URLs when complete. Optionally saves to `output_dir`. |

## Requirements

A [Google AI Studio API key](https://aistudio.google.com/) — set as `GEMINI_API_KEY`.

## Mock Mode

Run without an API key (returns fixture data of identical shape):

```bash
MOCK=true npx @fre4x/gemini
```

## Deploy

```json
{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "@fre4x/gemini"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Notes

- **Image generation** requires Imagen access — not available on all free-tier API keys. Check [AI Studio](https://aistudio.google.com/).
- **Video generation** is async. Call `generate_video` → poll `get_video_status` every ~30s until `done: true`.
- `analyze_media` accepts `file://` paths for local files and auto-detects MIME type from URL extension (jpg, png, mp4, mp3, wav, pdf, etc.). If you omit `prompt`, it defaults to "Describe this media.".
- `output_dir` on `generate_image` and `get_video_status` saves files to disk. Directory is created if it doesn't exist.

## Development

```bash
npm install
npm run dev      # tsx, no build
npm run build    # esbuild → dist/
npm test         # vitest unit tests
npm run inspector # MCP inspector in mock mode
```

## License

MIT — **WE ARE THE FRE4X.**
npm package: @fre4x/hn
Description: A Hacker News MCP server for LLMs.
Author: fritzprix
Latest version: 1.0.54

# hn — The Street Pulse

> *Every revolution began as a comment. This B1TE listens before it acts.*

Part of **[FRE4X-B1TE](../)** — a monorepo of MCP servers built for autonomous agents.

Hacker News is where technologists think out loud. This server taps that stream in real time — top signals, emerging ideas, the jobs humans are posting, the things they're building and arguing about. An informed agent is a dangerous agent.

## Tools

| Tool | What it reads |
|------|--------------|
| `hn_get_top_stories` | Current top stories (paginated) |
| `hn_get_new_stories` | Newest submissions (paginated) |
| `hn_get_best_stories` | All-time best stories (paginated) |
| `hn_get_ask_stories` | Ask HN threads (paginated) |
| `hn_get_show_stories` | Show HN threads (paginated) |
| `hn_get_job_stories` | Job postings (paginated) |
| `hn_get_item` | Full details for any item — story, comment, poll |
| `hn_get_user` | User profile and karma |
| `hn_get_updates` | IDs of recently changed items and profiles |
| `hn_get_max_item` | Latest item ID — the frontier of the stream |

All tools return paginated Markdown or JSON. Token limit enforced at ~3,000 tokens per response.

## Mock Mode

Run without any API key (returns fixture data of identical shape):

```bash
MOCK=true npx @fre4x/hn
```

## Deploy

```json
{
  "mcpServers": {
    "hackernews": {
      "command": "npx",
      "args": ["-y", "@fre4x/hn"]
    }
  }
}
```

## Development

```bash
npm install
npm run dev      # tsx, no build
npm run build    # esbuild → dist/
npm test         # vitest unit tests
```

## License

MIT — **WE ARE THE FRE4X.**
npm package: @fre4x/inspector-bridge
Description: MCP inspector bridge server for connecting agents to other MCP servers without a browser.
Author: fritzprix
Latest version: 1.0.54

# @fre4x/inspector-bridge

MCP server that lets AI agents **connect to, inspect, and test any MCP server at runtime** — no browser required.

It wraps the MCP SDK `Client` directly, so an agent can:
1. **Spawn** a target MCP server (stdio) or connect to a remote one (SSE / Streamable HTTP)
2. **Maintain a live session** and call multiple operations
3. **Tear down** the connection when done

---

## Tools

| Tool | Description |
|------|-------------|
| `inspector_connect` | Spawn/connect to an MCP server. Returns `session_id`. |
| `inspector_disconnect` | Close an active session. |
| `inspector_list_sessions` | List all active sessions with targets. |
| `inspector_list_tools` | List tools exposed by the connected server. |
| `inspector_call_tool` | Call a tool and return its result. |
| `inspector_list_resources` | List resources exposed by the server. |
| `inspector_read_resource` | Read a resource by URI. |
| `inspector_list_resource_templates` | List resource URI templates. |
| `inspector_list_prompts` | List prompts exposed by the server. |
| `inspector_get_prompt` | Retrieve a rendered prompt with arguments. |

---

## Usage

### Connecting to a stdio server

```
inspector_connect(command="node", server_args=["dist/index.js"])
→ { session_id: "session-0" }

inspector_list_tools(session_id="session-0")
→ { tools: [...] }

inspector_call_tool(session_id="session-0", tool_name="hn_get_top_stories", tool_args={ limit: 5 })
→ { content: [...] }

inspector_disconnect(session_id="session-0")
```

### Connecting to a remote server

```
inspector_connect(server_url="https://example.com/mcp", transport="http")
inspector_connect(server_url="https://example.com/sse", transport="sse",
                  headers={ "Authorization": "Bearer <token>" })
```

---

## Mock Mode

Run without any real server:

```bash
MOCK=true npx --yes --package @fre4x/inspector-bridge fre4x-inspector-bridge
```

All tools return realistic fixture data when `MOCK=true` or `INSPECTOR_MOCK=true`.

---

## Claude Desktop Configuration

```json
{
  "mcpServers": {
    "fre4x-inspector-bridge": {
      "command": "npx",
      "args": ["-y", "--package", "@fre4x/inspector-bridge", "fre4x-inspector-bridge"]
    }
  }
}
```
npm package: @fre4x/jules
Description: MCP server for Jules API integration
Author: fritzprix
Latest version: 1.0.54

# jules — The Coding Agent Bridge

> *Autonomous code changes, PR generation, and session management. The swarm's hands.*

Part of **[FRE4X-B1TE](../)** — a monorepo of MCP servers built for autonomous agents.

[Google Jules](https://jules.google.com/) is an autonomous coding agent. This B1TE exposes its full API as MCP tools — so your agent can spawn Jules sessions, approve plans, and get PRs merged without a human in the loop.

## Tools

| Tool | What it does |
|------|-------------|
| `jules_list_sources` | List connected GitHub repos available as sources |
| `jules_create_session` | Start a new Jules coding session with a prompt, source, and optional config |
| `jules_list_sessions` | List all sessions and their status (e.g. PR links) |
| `jules_approve_plan` | Approve a session's execution plan (when `requirePlanApproval=true`) |

### `jules_create_session` parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `source` | string | Source resource name, e.g. `sources/github/owner/repo` |
| `title` | string | Session title |
| `prompt` | string | Task description for Jules |
| `startingBranch` | string | Branch to start from (default: `main`) |
| `automationMode` | string | `AUTO_CREATE_PR` or `NONE` (default: `NONE`) |
| `requirePlanApproval` | boolean | If true, pause for `jules_approve_plan` before executing (default: false) |

## Requirements

A [Jules API key](https://jules.google.com/settings#api) — set as `JULES_API_KEY`.

## Mock Mode

Run without an API key (returns fixture data of identical shape):

```bash
MOCK=true npx @fre4x/jules
```

## Deploy

```json
{
  "mcpServers": {
    "jules": {
      "command": "npx",
      "args": ["-y", "@fre4x/jules"],
      "env": {
        "JULES_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Development

```bash
npm install
npm run dev      # tsx, no build
npm run build    # esbuild → dist/
npm test         # vitest unit tests
```

## License

MIT — **WE ARE THE FRE4X.**