flconsole — free Upwork MCP server

---

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.
• New jobs only. Jobs posted in the last 30 minutes; no search in older jobs.
• Your feeds, shared with Telegram. A feed your agent creates also sends alerts to the Telegram bot 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
• Tools
• Prompts to start with
• With Upwork's own MCP
• Limits
• Links

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: Settings → 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.

Tools

Tool	What it does
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 with filters and status
create_feed	Creates a feed; needs your approval
update_feed	Changes, pauses or resumes a feed
delete_feed	Deletes a feed; needs your approval
preview_filters	How many jobs matched in the last hours, 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

Arguments, filters and job fields: MCP reference.

Prompts to start with

Check new jobs in my feeds and show only relevant ones.

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

On a schedule in Claude Code:

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

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

	Limit
Feeds	5 (shared with Telegram)
find_jobs	100 jobs an hour, 1,000 a day, one call every 60 seconds
get_job_details	30 jobs an hour
Feed changes	20 an hour
preview_filters	10 an hour
parse_upwork_url	30 an hour
Connections	5 apps at a time

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.