# flconsole — Upwork jobs [Verified owner] [Health: Active]

**Category:** 🏢 Workplace & Productivity  
**Repository:** https://github.com/droopboop/flconsole-upwork-mcp  
**GitHub Stars:** 0  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/flconsole-upwork-jobs

## Description
Free hosted MCP server that monitors new Upwork jobs and delivers matching listings to AI agents including Claude Code, Codex, Cursor, and the Claude app. Telegram sign-in is required; no Upwork login or API key is needed.

## Tools
Capabilities this server exposes over MCP:

- **get_agent_context** — Start of a session: how-to, the agent's notes about you and all your feeds
- **find_jobs** — New jobs by a feed, all feeds or any filters
- **get_job_details** — Full data for the jobs you picked
- **list_feeds** — Your feeds: filters, AI filter, alerts on or off, paused
- **create_feed** — Saves a feed (alerts off unless you ask); needs your approval
- **update_feed** — Changes a feed's search, filters, AI filter or the agent's notes
- **set_feed_alerts** — Turns Telegram alerts for a feed on or off; needs your approval
- **set_feed_paused** — Pauses or resumes a feed
- **delete_feed** — Deletes a feed; needs your approval
- **save_agent_instructions** — Saves the agent's notes about you: preferences, conclusions
- **preview_filters** — How many jobs matched over the last 7 days: total, ~per day and per UTC day, with samples
- **parse_upwork_url** — Turns an Upwork search link into filters
- **list_categories** — Upwork categories and subcategories
- **find_locations** — Countries and regions by name
- **get_usage** — What's left of your limits
- **get_skill** — Step-by-step instructions for a task: job scout, Telegram setup, feed tuner, AI filter, ratings
- **rate_job** — 👍/👎 a job for you, only when you say so
- **tuner_checkin** — Feed tuner: which feeds are due for a check now
- **get_feed_report** — Feed tuner: jobs sent and opened, your 👍/👎, what the AI filter skipped, recent changes
- **set_feed_tuner** — Turns the feed tuner on or off for a feed, with your target jobs a day; needs your approval
- **log_tuner_run** — Feed tuner: records what was checked and changed; you get the change in Telegram with Undo

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "flconsole-upwork-jobs": {
    "url": "https://flconsole.com/mcp?utm_source=github&utm_medium=referral&utm_campaign=repo"
  }
}
```

## Documentation

## What flconsole — Upwork jobs does

Upwork job discovery is exposed as MCP tools through the hosted endpoint `https://mcp.lite.flconsole.com/mcp`. An agent can search newly posted jobs with keyword, job, and client filters, retrieve full details for selected listings, and use saved feeds to repeat searches across sessions.

Feeds can include search criteria, an AI filter written in plain language, alert settings, pause state, and agent-maintained notes. The service also stores notes about the user's preferences and conclusions, allowing an agent to recover context through `get_agent_context`. Alerts are optional: a feed can remain available to the agent without sending anything to Telegram.

## How it works

The server uses Streamable HTTP rather than a locally installed process. Connect an MCP-compatible client to the hosted URL, then authenticate through Telegram. The browser sign-in flow opens Telegram or a QR code, asks the user to approve the requesting app, and returns a short code for the sign-in page. A sign-in link remains valid for 10 minutes.

Once connected, an agent can search on demand with `find_jobs`, or save a feed with `create_feed`. Alerts must be explicitly enabled with `set_feed_alerts`; when enabled, the Telegram bot sends new matching jobs and applies the feed's AI filter. The feed tuner can check feed performance, review jobs sent and opened, account for ratings and skipped jobs, and record changes with an undo notification in Telegram.

## Setup and configuration

No package installation or local service is required. Add the endpoint to a supported client using its remote MCP configuration:

- Claude Code: `claude mcp add --transport http flconsole https://mcp.lite.flconsole.com/mcp`
- Codex: `codex mcp add flconsole --url https://mcp.lite.flconsole.com/mcp`
- Cursor: add the URL under an `flconsole` entry in `~/.cursor/mcp.json`.
- Claude app: add a custom connector under Customize → Connectors.

Authenticate when the client prompts you. Clients without sign-in support can use a manual bearer token obtained from the Telegram bot through `/mcp` → Manual token (other apps). The service does not require an Upwork password, Upwork account access, or API key.

## Tools and capabilities

- Search new jobs with `find_jobs`, inspect selected listings with `get_job_details`, and review remaining limits with `get_usage`.
- Create, update, pause, resume, list, and delete feeds, with approval required for feed creation, deletion, and alert changes.
- Turn an Upwork search URL into filters with `parse_upwork_url`; inspect categories with `list_categories` and locations with `find_locations`.
- Save agent instructions and retrieve session context so preferences and feed information persist across agents.
- Preview seven-day filter matches, including totals, approximate daily volume, UTC-day counts, and samples.
- Configure feed tuning, review reports, rate jobs when requested, and record tuner runs.

## Limitations and notes

The service is hosted, so deployment and local runtime management are outside the client configuration. Telegram is required for sign-in, and it is also the notification channel for enabled alerts. Search-only use does not save anything; persistent feeds and agent notes are stored on the service. A feed with alerts disabled is checked by the agent rather than continuously running server-side. Users can disconnect apps later from the Telegram bot through `/mcp` → Disconnect.

_Full upstream README: https://allmcps.com/mcp/flconsole-upwork-jobs/readme_

