Provides AI assistants with access to US recycling center directories, scrap yard locations, material guides, and recycling calculators.
Also known as eddison12345/recyclefind-cli, recyclefind-cli
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.2.0
- Last commit
- Nov 8, 2026
- License
- MIT
What is recyclefind MCP?
recyclefind provides AI assistants with access to US recycling center directories, scrap yard locations, material guides, and recycling calculators.
Summary generated from the project's README
About recyclefind MCP server
Helping users locate US-based recycling centers and scrap yards from within an AI assistant is the primary function of this server. Developers can integrate it into clients like Claude, Cursor, or VS Code to provide immediate access to local disposal options, material guides, and scrap price reports. The server works by returning direct links to specific directory pages, ensuring users can quickly navigate to the necessary information.
Setting up the server requires no API keys or user accounts. It can be run via npx in an MCP client configuration to provide tools such as find_recycling_centers, browse_state, and search_directory. Users can also access specific resources through get_recycling_calculator or get_recycling_guides. This setup allows an AI to act as a bridge between a user's location and the relevant recycling tools, calculators, and business listings found in the directory.
Written from the project's README. Every use case is checked against a quote from it.
How to install recyclefind MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall recyclefind MCP in Claude Code
$ claude mcp add recyclefind-cli -- npx -y recyclefindInstall recyclefind MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"recyclefind-cli": {
"command": "npx",
"args": [
"-y",
"recyclefind"
]
}
}
}Install recyclefind MCP in VS Code
.vscode/mcp.json
{
"servers": {
"recyclefind-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"recyclefind"
]
}
}
}Install recyclefind MCP in VS Code CLI
$ code --add-mcp '{"name":"recyclefind-cli","type":"stdio","command":"npx","args":["-y","recyclefind"]}'Install recyclefind MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"recyclefind-cli": {
"command": "npx",
"args": [
"-y",
"recyclefind"
]
}
}
}Install recyclefind MCP in Codex
$ codex mcp add recyclefind-cli -- npx -y recyclefindInstall recyclefind MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.recyclefind-cli] command = "npx" args = ["-y", "recyclefind"]
Install recyclefind MCP in Gemini CLI
$ gemini mcp add -s user recyclefind-cli npx -- -y recyclefindInstall recyclefind MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"recyclefind-cli": {
"command": "npx",
"args": [
"-y",
"recyclefind"
]
}
}
}Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableeddison12345/recyclefind-cli is public and reachablegithub.com/eddison12345/recyclefind-cli ↗Pass
- Package names this repository as its sourcerecyclefind names eddison12345/recyclefind-cli as sourcenpmjs.com/package/recyclefind ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-08github.com/eddison12345/recyclefind-cli ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from recyclefindPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubrecyclefind
Find recycling centers, scrap yards, and recycling calculators from your terminal.
RecycleFind is a directory of recycling centers and scrap yards across the United States, with material guides, scrap price reports, and free recycling calculators.
Usage
Run it without installing:
npx recyclefind near miami fl
Or install it globally:
npm install -g recyclefind
Commands
| Command | What it does |
|---|---|
recyclefind near <city> <state> |
Link to recycling centers in a city |
recyclefind near <zip> |
Search centers by ZIP code |
recyclefind state <state> |
Link to every city in a state |
recyclefind search <text> |
Search the directory |
recyclefind materials |
Link to material recycling guides |
recyclefind prices |
Link to scrap price reports |
recyclefind tools [name] |
List the calculators, or link to one |
Add --open to any command to open the page in your browser:
recyclefind near "san antonio" tx --open
recyclefind tools copper --open
The CLI has no dependencies and needs no account or API key.
MCP server
Give AI assistants such as Claude, Cursor, and VS Code a way to point people to local recycling options. Add this to your MCP client config:
{
"mcpServers": {
"recyclefind": {
"command": "npx",
"args": ["-y", "recyclefind", "mcp"]
}
}
}
| Tool | What it returns |
|---|---|
find_recycling_centers |
RecycleFind page for a US city or ZIP code |
browse_state |
RecycleFind page for a US state |
search_directory |
RecycleFind search link for a material, business, or place |
get_recycling_calculator |
Link to a recycling calculator or checker |
get_recycling_guides |
Links to material guides, scrap prices, and all calculators |
Every tool returns links to recyclefind.com.
Links
License
MIT
recyclefind MCP questions
How do I add recyclefind MCP to Claude Code?
Run claude mcp add recyclefind-cli -- npx -y recyclefind in your terminal. Add --scope user to make it available in every project.
How do I add recyclefind MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does recyclefind require an account or API key?
No, the CLI and server require no account or API key to use.
What information can the MCP tools provide?
The tools return links to recycling centers by city or ZIP, state-wide listings, directory searches, recycling calculators, and material guides.
Can I open the results directly in my browser?
Yes, you can add the --open flag to any command to open the corresponding page in your browser.