NeedToFind

app.needtofindPublished by needtofind.appOfficial publisherv1.0.1Updated Oct 24, 2026

Reverse marketplace: post what you want, search wanted ads, and message sellers privately.

VerifiedStreamable HTTPWeb executableCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

A hosted reverse-marketplace server that lets an assistant post and search wanted ads, read and answer seller responses, and set up email alerts.

What you can do
List categories and search open wanted ads, including what is new since a given time or a saved point in time, and view your own ads and responses sent to others. Post a wanted ad with title, description, category, optional budget and location, and close it when the item is found. Read the responses and private message threads on your ads, and reply within a conversation. Respond to other people's ads to say you have the item, and create, list or delete keyword and category email alerts.
When to use it
Use it when you want an assistant to handle the reverse-marketplace workflow: publishing a want, watching for new matching demand, and triaging replies from sellers without opening the website.
Requirements
Remote streamable HTTP endpoint at needtofind.app/mcp. A free NeedToFind account and a personal access token, sent as an Authorization bearer header (or the X-NeedToFind-Token header where Authorization is reserved). OAuth-only clients are not supported.
Before you install
The token acts as your whole account, so keep it private and revoke it if exposed. Ads are public, and responding to an ad or replying in a thread emails the other person your message and contact details. Posting, responding, replying, closing ads and deleting alerts change data; the server flags which tools are destructive. Account limits apply, including 25 open ads, 20 responses per day and 60 requests per minute.

Installation

In SourceWeft

  1. Open NeedToFind in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/app.needtofind%2Fneedtofind/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "needtofind": {
      "type": "http",
      "url": "https://needtofind.app/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

NeedToFind MCP server

NeedToFind is a reverse marketplace: instead of searching other people's listings, you post what you're looking for and the people who have it get in touch. This MCP server lets an AI assistant do that for you: post a wanted ad, search open ads, read and answer responses, and set up email alerts.

  • Server URL: https://needtofind.app/mcp (remote, streamable HTTP)
  • Auth: a personal access token from a free NeedToFind account
  • Cost: free. No listing fees, no commissions.
  • Also listed on: the official MCP Registry (app.needtofind/needtofind) and Smithery

This repository holds the documentation and registry metadata for the hosted server. The NeedToFind application itself is not published here.

Get a token

  1. Create a free account at needtofind.app.
  2. Open your profile page and create a token under API tokens (shown once; up to 10 per account).
  3. Keep it private. Anyone with the token can act as you on NeedToFind. You can revoke it from the same page at any time.

Connect your client

Claude Code

bash
claude mcp add --scope user --transport http needtofind https://needtofind.app/mcp --header "Authorization: Bearer YOUR_TOKEN"

Any client that supports remote HTTP servers with custom headers

json
{  "mcpServers": {    "needtofind": {      "type": "http",      "url": "https://needtofind.app/mcp",      "headers": { "Authorization": "Bearer YOUR_TOKEN" }    }  }}

Some gateways reserve the Authorization header. The server also accepts the same token as X-NeedToFind-Token: YOUR_TOKEN, with or without a Bearer prefix.

Smithery

Install info-mw9d/needtofind from Smithery and paste your token when asked.

Clients that only support OAuth

Not supported yet. Connections use personal access tokens.

Tools

ToolWhat it does
list_categoriesList the categories and their groups. Use the names exactly as given; the list can change.
search_wantsSearch open wanted ads, optionally by category. Good for checking whether someone already posted a similar want, or finding wants you could fulfil.
whats_newList open wanted ads posted since a time (default 24 hours, up to 30 days back), with a next_since value to pass back next time. For noticing new demand without re-running a search.
post_wantPost a wanted ad (title, description, category, optional budget and location). Live for 30 days unless renewed or closed.
my_wantsList your own ads, any status.
get_responsesRead the responses sellers sent to one of your ads, including the private message thread with each seller.
close_wantClose one of your ads, optionally marking the item as found.
respond_to_wantRespond to someone else's ad to say you have the item. The buyer is emailed your message and contact details.
my_responsesList the responses you've sent to other people's ads, with message threads and unread counts.
reply_to_responseSend a private message in a response's conversation (as buyer or seller). The other person is emailed.
set_alertEmail me when a new ad matches my keywords and/or category (for sellers who want to hear about demand).
list_alertsList your saved alerts.
delete_alertDelete an alert.

Every tool declares whether it is read-only, destructive or idempotent, so clients can decide when to ask you first. Tools that email other people (respond_to_want, reply_to_response) are described to the model as things to do only when you ask.

Limits

Open ads per account25
Ad lifetime30 days (renewable)
Photos per adup to 4 (added on the website; MCP tools can't upload files)
Responses you can send20 per day
Alerts per account10
MCP requests60 per minute per account
Tokens per account10

Privacy

  • Ads are public. Responses and message threads are private between the buyer and that one seller.
  • The server only acts as the account that owns the token.
  • Details: Privacy Policy and Terms.

Example prompts

  • "Search NeedToFind for a Marantz 2270 receiver."
  • "What new wanted ads were posted in Boats since yesterday?"
  • "Post a wanted ad for a Yanmar 3GM30 fuel injector, budget $200, in Key West, FL."
  • "Did anyone respond to my injector ad? Summarize the replies."
  • "Alert me when someone posts a want for vintage audio gear."

Support

Use the contact form at needtofind.app/contact.

NeedToFind is a project of Gray Penguin Development.

Source: README.md at commit f79a9ca

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

2
  1. v1.0.1LatestOct 1, 2026
  2. v1.0.0Sep 30, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts