Tewdy

dugiwarc/tewdy-stack

Eleven JSON-RPC tools over streamable HTTP that let Claude or ChatGPT search for local service providers by category and location, pull pricing data, and estimate provider earnings in specific markets. Five tools are read-only and public: search_providers, get_provider_details, list_categories, get_category_pricing, and get_earnings_estimate. The other six require a Tewdy JWT and handle transactional flows like requesting quotes, messaging providers, and submitting bids. OAuth 2.1 with PKCE is built in for supported clients. Useful if you're building workflows that need to surface real plumbers in Lisbon or translators in Berlin, or if you want to answer "how much could I earn as a tutor in this city" with actual market data instead of guesses.

tools: 11
transport: HTTP
last updated: Apr 28, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.tewdy.com --name tewdy

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http tewdy https://mcp.tewdy.com

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 11 tools

Verified live against the running server on Nov 6, 2026.

search_providersSearch Tewdy for service providers (plumbers, translators, tutors, cleaners, etc.) by category and/or location. Returns a ranked list including name, rating, response time, and Tewdy profile tag.7 params

Search Tewdy for service providers (plumbers, translators, tutors, cleaners, etc.) by category and/or location. Returns a ranked list including name, rating, response time, and Tewdy profile tag.

Parameters* required

categorystring

latnumber

limitinteger

lngnumber

locationNamestring

querystring

radiusKmnumber

get_provider_detailsLook up the full public profile for a Tewdy provider. Accepts either a Tewdy UUID (returned by search_providers as `id`) or a tewdyTag handle (e.g. "marcus-chen", returned as `tewdyTag`). Returns name, jobTitle, bio, profile picture, languages, capability pricing, ratings, ver...1 params

Look up the full public profile for a Tewdy provider. Accepts either a Tewdy UUID (returned by search_providers as `id`) or a tewdyTag handle (e.g. "marcus-chen", returned as `tewdyTag`). Returns name, jobTitle, bio, profile picture, languages, capability pricing, ratings, ver...

Parameters* required

provider_id*string

list_categoriesList the service categories Tewdy supports (plumbing, translation, tutoring, cleaning, etc.). Returns slug, name, description, and businessType for each. Use this to map a free-text user request to a known category before calling search_providers. Optional business_type filter...1 params

List the service categories Tewdy supports (plumbing, translation, tutoring, cleaning, etc.). Returns slug, name, description, and businessType for each. Use this to map a free-text user request to a known category before calling search_providers. Optional business_type filter...

Parameters* required

business_typestring

get_category_pricingGet aggregated price ranges for a service category, optionally filtered by location. Prefers transacted prices (accepted quotes) when at least 5 samples exist; otherwise falls back to listed (asking) prices from provider capability pricing. Returns median, p25, p75, min, max,...3 params

Get aggregated price ranges for a service category, optionally filtered by location. Prefers transacted prices (accepted quotes) when at least 5 samples exist; otherwise falls back to listed (asking) prices from provider capability pricing. Returns median, p25, p75, min, max,...

Parameters* required

category*string

currencystring

locationstring

get_earnings_estimateEstimate weekly and monthly earnings for a Tewdy provider in a given category. Uses listed hourly rates from existing providers as the baseline and projects earnings under three utilisation scenarios (40%/60%/80%). Returns ranges, not guarantees.4 params

Estimate weekly and monthly earnings for a Tewdy provider in a given category. Uses listed hourly rates from existing providers as the baseline and projects earnings under three utilisation scenarios (40%/60%/80%). Returns ranges, not guarantees.

Parameters* required

category*string

currencystring

hours_per_week*number

locationstring

request_quoteCompose a Tewdy quote request from the user's description. Returns a deep link to the Tewdy app with all fields pre-filled; the user reviews and clicks publish to actually post the request. This tool deliberately does not auto-post — quote acceptance and payment confirmation a...8 params

Compose a Tewdy quote request from the user's description. Returns a deep link to the Tewdy app with all fields pre-filled; the user reviews and clicks publish to actually post the request. This tool deliberately does not auto-post — quote acceptance and payment confirmation a...

Parameters* required

budget_maxnumber

budget_minnumber

categorystring

currencystring

description*string

location_namestring

preferred_datestring

urgencystring

one of urgent · normal · flexible

get_my_requestsList the authenticated user's quote requests with current status (open / closed / cancelled / expired) and quote-response counts. Read-only — no state changes. Requires authentication.5 params

List the authenticated user's quote requests with current status (open / closed / cancelled / expired) and quote-response counts. Read-only — no state changes. Requires authentication.

Parameters* required

limitinteger

offsetinteger

sort_bystring

one of createdAt · expiresAt · quotesReceived

sort_orderstring

one of ASC · DESC

statusstring

one of open · closed · cancelled · expired

accept_quoteLook up a quote and return a deep link to the Tewdy app where the user can confirm acceptance and proceed to payment. This tool deliberately does not accept or pay — quote acceptance and payment confirmation always happen on tewdy.com via the deep link, not in chat. Requires a...1 params

Look up a quote and return a deep link to the Tewdy app where the user can confirm acceptance and proceed to payment. This tool deliberately does not accept or pay — quote acceptance and payment confirmation always happen on tewdy.com via the deep link, not in chat. Requires a...

Parameters* required

quote_id*string

message_providerSend a chat message into an existing Tewdy thread (typically created when a quote was submitted or accepted). The chat_id is the same id surfaced by get_my_requests or accept_quote. Requires authentication.2 params

Send a chat message into an existing Tewdy thread (typically created when a quote was submitted or accepted). The chat_id is the same id surfaced by get_my_requests or accept_quote. Requires authentication.

Parameters* required

chat_id*string

text*string

list_inbound_requestsFor the authenticated provider, list open quote requests that match the provider's capabilities and service area. Optional filters: category, location radius, budget range, urgency. Read-only. Use this to find work to quote on. Requires authentication.9 params

For the authenticated provider, list open quote requests that match the provider's capabilities and service area. Optional filters: category, location radius, budget range, urgency. Read-only. Use this to find work to quote on. Requires authentication.

Parameters* required

category_idstring

latnumber

limitinteger

lngnumber

max_budgetnumber

min_budgetnumber

offsetinteger

radius_kmnumber

urgencystring

one of urgent · normal · flexible

submit_quoteSubmit a quote on an open quote request. The provider sets the estimated price, optional duration and availability, and a short message to the requester. The quote is not a financial commitment — the requester still has to accept (which itself goes through a deep-link confirma...9 params

Submit a quote on an open quote request. The provider sets the estimated price, optional duration and availability, and a short message to the requester. The quote is not a financial commitment — the requester still has to accept (which itself goes through a deep-link confirma...

Parameters* required

availability_datestring

business_idstring

currency*string

estimated_durationstring

estimated_price*number

message*string

provider_type*string

one of individual · business

quote_request_id*string

terms_conditionsstring