flconsole

flconsole is a free service that watches new Upwork jobs and delivers matching ones to your Telegram or to your AI agent over MCP.

This repository holds ready-to-paste configs and a short guide. The server is hosted — there is nothing to install or run.

https://mcp.lite.flconsole.com/mcp

• Free. No card, no API key, no paid plan.

• One feed, for your agent and your phone. Your agent saves searches as feeds on the server; turn on alerts for any of them with one command and the Telegram bot sends matching jobs within a minute of posting.

• No access to your Upwork account. flconsole never asks for your Upwork login.

Contents

• Connect — Claude Code, Codex, Claude app, Cursor, other clients

• Sign-in

• Three ways to work

• Tools

• Prompts to start with

• Skill for Claude Code

• No terminal? Install in Claude app

• With Upwork's own MCP

• Limits

• Links

Related MCP server: upwork-mcp

Connect

Claude Code

claude mcp add --transport http flconsole https://mcp.lite.flconsole.com/mcp

Add --scope user to use it in all your projects. Then run /mcp → flconsole → Authenticate. Guide: flconsole in Claude Code · file: configs/claude-code.sh

Codex

codex mcp add flconsole --url https://mcp.lite.flconsole.com/mcp
codex mcp login flconsole

The second command opens the sign-in page in your browser. Guide: flconsole in Codex · file: configs/codex.sh

Claude app

Web, desktop and mobile: Customize → Connectors → + → Add custom connector, paste the server URL:

https://mcp.lite.flconsole.com/mcp

Guide: flconsole in the Claude app

Cursor

Add to ~/.cursor/mcp.json, then sign in when Cursor asks:

{
  "mcpServers": {
    "flconsole": { "url": "https://mcp.lite.flconsole.com/mcp" }
  }
}

Guide: flconsole in Cursor · file: configs/cursor.mcp.json

Other clients

Any MCP client with Streamable HTTP works. If it supports sign-in (OAuth), add the server URL and sign in as below. If it doesn't, use a manual token: in the Telegram bot send /mcp → Manual token (other apps), then send it as Authorization: Bearer <token>. Examples: configs/manual-token.claude-code.sh, configs/manual-token.codex.toml.

Sign-in

Through Telegram — no password, no API key:

1. Your client opens a sign-in page in the browser.

2. Tap Continue in Telegram (or scan the QR code). The flconsole bot opens; if you're new, tap Start.

3. The bot names the app that wants access. Tap Allow and get a 4-digit code.

4. Enter the code on the sign-in page. Done.

The sign-in link works for 10 minutes. Disconnect any app later in the bot: /mcp → Disconnect.

Three ways to work

A feed with alerts off is for your agent only: nothing goes to Telegram and nothing runs on the server — your agent checks it with find_jobs and applies your AI filter itself. You see both kinds in the bot's /feeds, where you can turn alerts on or off, pause or delete a feed.

Tools

Arguments, filters and job fields: MCP reference.

Prompts to start with

Find new React Native jobs: hourly from $40, clients from the US or Canada with verified payment. Show only the ones about fintech.

Check new jobs in my flconsole feeds and show only the ones that fit.

Save this Upwork search link as a feed: <link>. Show me the filters before saving.

Turn on Telegram alerts for my React Native feed.

On a schedule in Claude Code:

/loop 10m check new jobs in my feeds and show only relevant ones

Skill for Claude Code

skills/upwork-job-hunter turns your agent into a job scout. No feed needed: the agent searches new jobs with your query and filters and reads every job itself.

• Picks up where you left off. Every session starts with get_agent_context: your feeds and what the agent learned about you are kept on the server, so any agent on any device continues the same work. Prefer a local file? Say so, and it keeps upwork-job-hunter.md instead.

• Setup in 3 steps, like the onboarding of the Telegram bot: what to search, job and client filters, and your own AI criteria in plain words. The agent counts matching jobs at every step and suggests how to sharpen the search.

• Your AI filter, applied by your agent. It tests your criteria on real jobs, shows what passed and why, and you adjust them.

• Shortlist with reasons on every check, and proposal drafts for the jobs you pick. Nothing is sent for you.

• Tuning with numbers. Too many jobs, too few or not the right ones — the agent shows the counts and offers concrete changes to the search, filters and criteria.

• Telegram alerts when you want them: one command turns them on for the same feed, with the same AI filter.

Install it with the skills CLI (add -g to use it in all your projects):

npx skills add droopboop/flconsole-upwork-mcp

Or copy it into ~/.claude/skills/:

mkdir -p ~/.claude/skills/upwork-job-hunter && curl -fsSL https://raw.githubusercontent.com/droopboop/flconsole-upwork-mcp/main/skills/upwork-job-hunter/SKILL.md -o ~/.claude/skills/upwork-job-hunter/SKILL.md

Then ask Claude Code:

Set up my Upwork job search.

No terminal? Install in Claude app

Works in the Claude app on the web and on desktop.

1. Open Customize → Connectors, click + → Add custom connector and paste https://mcp.lite.flconsole.com/mcp. Click Connect and sign in through Telegram (see Sign-in).

2. Quickest: paste a prompt. Copy the ready prompt and paste it at the start of a chat, or into the instructions of a Claude project.

Want it installed? Add the skill. After step 1:

1. Download upwork-job-hunter.zip. Don't unzip it.

2. In Claude, open Customize → Skills, click + → Create skill → Upload a skill and pick the file. Make sure the skill is turned on. If you don't see Skills, turn on Code execution and file creation in Settings → Capabilities.

3. Start a new chat and say:

Set up my Upwork job search.

With Upwork's own MCP

Upwork has its own MCP server for actions in your account. Use flconsole to find new jobs and Upwork's MCP to send proposals: your agent never runs repeated searches from your Upwork account. A freelancer reports a policy violation after checking Upwork's MCP for new jobs every 15 minutes.

Every 15 minutes, check new jobs in my flconsole feeds, pick the ones that fit, draft a proposal for each and ask me before sending anything through Upwork.

Setup: flconsole + Upwork's MCP

Limits

get_usage shows what's left.

Links

• Website: flconsole.com

• MCP server: flconsole.com/mcp

• MCP reference: flconsole.com/docs/mcp

• Telegram bot: @flconsole_upwork_job_alerts_bot

• Compare with paid tools: flconsole.com/compare

• Privacy: flconsole.com/privacy · Terms: flconsole.com/terms

The configs and text in this repository are under the MIT License. The hosted service follows its terms of use.