flconsole MCP server

The flconsole MCP server gives your AI agent new Upwork jobs and your job feeds. Your agent finds new jobs, reads them and shows you the ones that fit. This page lists every tool, argument, filter and limit.

Overview

• New jobs only. The server returns jobs posted in the last 30 minutes. There is no search in older jobs.
• Your agent asks; the server doesn't push. The agent checks for new jobs when you ask it or on a schedule. For alerts within a minute of posting, use the Telegram bot.
• Feeds are shared with Telegram. A feed your agent creates shows up in the bot under /feeds, and its alerts arrive in Telegram. Up to 5 feeds in total.
• No access to your Upwork account. flconsole never asks for your Upwork login and can't act in your account.
• Your agent does the reading. Filters are structured JSON. Picking jobs by meaning is done by your agent, not by the server.

Connect

Add the server to your client, then sign in. Sign-in works the same way everywhere:

1. Your client opens a sign-in page in the browser.
2. Tap Continue in Telegram (or scan the QR code with your phone). The flconsole bot opens. If you're new, tap Start — that's all it takes.
3. The bot names the app that wants access. Tap Allow, and the bot shows a 4-digit code.
4. Enter the code on the sign-in page. Your client is connected.

The sign-in link works for 10 minutes. After 5 wrong codes the request is cancelled; start again in your client.

Claude Code

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

Add --scope user to make the server available in all your projects. Then run /mcp in Claude Code, pick flconsole and choose Authenticate.

To check jobs on a schedule: /loop 10m check new jobs in my feeds and show only relevant ones. Step-by-step guide: flconsole in Claude Code.

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.

Claude app

Web, desktop and mobile: Settings → Connectors → Add custom connector, then paste https://mcp.lite.flconsole.com/mcp. The app opens the sign-in page. Guide: flconsole in the Claude app.

Cursor

Add the server to ~/.cursor/mcp.json:

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

Then sign in from Cursor's MCP settings when it asks. Guide: flconsole in Cursor.

Other clients

Any MCP client with Streamable HTTP works. If it supports sign-in (OAuth), add the server URL and sign in as above. If it doesn't, use a manual token.

Manual token

For clients without sign-in support. In the Telegram bot, send /mcp and tap Manual token (other apps). The bot shows the token once and doesn't store it, together with ready-to-paste commands.

Send it as a header: Authorization: Bearer <token>.

Claude Code:

claude mcp add --transport http flconsole https://mcp.lite.flconsole.com/mcp \
  --header "Authorization: Bearer <token>"

Codex, in ~/.codex/config.toml, with the token in an environment variable:

[mcp_servers.flconsole]
url = "https://mcp.lite.flconsole.com/mcp"
bearer_token_env_var = "FLCONSOLE_MCP_TOKEN"

export FLCONSOLE_MCP_TOKEN=<token>

Lost or leaked a token? Revoke it in /mcp and create a new one. Manual tokens and sign-ins share the limit of 5 connections.

Tools

The server has 11 tools.

Every tool also counts toward 60 calls a minute per connection.

Filters

create_feed, update_feed, preview_filters and find_jobs take the same filters object:

{
  "schema_version": 1,
  "base": {
    "q": "elevenlabs OR vapi OR retell",
    "t": ["hourly"],
    "hourly_rate": { "min": 40, "max": null },
    "contractor_tier": ["expert"],
    "location": { "include": ["United States", "Western Europe"], "exclude": [] },
    "payment_verified": true
  },
  "advanced": {
    "cl_total_spent": { "min": 10000, "max": null },
    "cl_rating": { "min": 4.5, "max": null }
  }
}

• schema_version is required and is always 1.
• A key that is omitted, null or [] is not set. Yes/no filters take true, false or null (any).
• Ranges are { "min": …, "max": … }; either side can be null.
• Unknown keys are rejected with invalid_filters, so a typo never silently filters nothing.
• Client filters: a client without that statistic doesn't match a range.

base

A job matches if it is in any of the listed categories or subcategories.

advanced

Search syntax

base.q works like the search box on Upwork:

react native          both words
"voice agent"         exact phrase
vapi OR retell        any of them
python NOT wordpress  exclude a word

• At least 3 letters: a shorter search matches almost every job.
• Not only exclusions: NOT wordpress alone is rejected. Add words to look for.
• Up to 1,000 characters. Parentheses group terms: (vapi OR retell) AND voice.
• Search in English: Upwork jobs are posted in English.
• Upwork search can't read field names like skills:, the characters / [ ] ~, or * at the start of a word. Such a query is rejected with invalid_query.
• Rates, locations and client requirements belong in filters, not in the search.

Job fields

find_jobs returns short cards: enough to judge a job by its text. get_job_details adds the terms and the client's history.

The client's name is never returned. link is a short flconsole link that opens the job on Upwork; if a short link can't be made, it is the direct upwork.com link.

Limits

Hourly quotas reset at the start of each hour (UTC), the daily quota at midnight UTC. get_usage shows what's left. MCP quotas don't affect Telegram alerts, and Telegram alerts don't use MCP quotas.

The server enforces these limits; your agent can't lift them, even if you ask.

Errors

A failed call returns a normal tool result marked as an error, so your agent can read it and fix the call:

{ "error": { "code": "filters_too_broad", "message": "…", "field": "filters", "retry_after_seconds": 60 } }

field and retry_after_seconds appear when they apply.

filters_too_broad

Your filters without a feed match more than 100 jobs in the window. Nothing is returned and no quota is used. Put every criterion into filters: category, job type, rate or budget, experience level, location, client statistics. Make the search more specific with OR, AND and parentheses. preview_filters shows how many jobs a set of filters matches. Try again after retry_after_seconds.

Quota exceeded

quota_exhausted means the 100 jobs for this hour or the 1,000 for today have already been returned. The message says when the quota resets; retry_after_seconds is the wait. get_job_details and the other tools answer rate_limited when their hourly limit is used up. Narrow your filters so fewer, better jobs use the quota.

skipped_count

skipped_count above 0 means more jobs matched than were returned. The skipped jobs are not returned later. The response then also has a warning. Narrow the filters or the feed's search so that everything that matches fits into one response.

Too frequent checks

too_early means less than 60 seconds have passed since your last check. Wait retry_after_seconds. Nothing is lost: the next check returns the jobs posted in between. For regular monitoring, a check every 5–15 minutes is enough.

Security

• Sign-in through Telegram. You approve each new connection in the bot and enter a 4-digit code on the sign-in page. Never share the code: whoever has it gets access to your feeds.
• No password, no API key. Connections use tokens; flconsole stores only their hashes. A sign-in session lasts up to 90 days from its last use.
• Every feed change is reported in Telegram. When your agent creates, changes, pauses, resumes or deletes a feed, the bot tells you. You see it even after /stop, so you notice a connection you didn't make.
• Your approval for every write. create_feed, update_feed and delete_feed require user_confirmed: true, which your agent may pass only after you agreed in the conversation.
• Disconnect any time. In the bot, send /mcp: it lists your connections with the date they were created and last used. Disconnect one, and it loses access right away. Your feeds stay.
• No access to your Upwork account. The server only reads public job data and your flconsole feeds.

See also: Privacy.

Good to know

Can the agent search old jobs?

No. Only jobs posted in the last 30 minutes.

Does my agent get jobs pushed to it?

No. It checks when you ask or on a schedule. Telegram alerts arrive within a minute.

What does the agent see about a job?

Title, description, skills, job type, budget or rate, and the client's country. Full details are available for the jobs it picks.

How do I disconnect an agent?

In the Telegram bot: /mcp.