> ## Documentation Index
> Fetch the complete documentation index at: https://docs.earthcare.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools reference

> Every tool the Earth Care Network MCP server exposes, grouped by capability, with an example prompt for each.

The server exposes **44 tools**. Call `tools/list` to fetch the live catalog with
full input schemas, or `GET /mcp/health/` for just the names. Every tool runs
scoped to the organization tied to your API key.

<Tip>
  Many `tools/list` descriptions are prefixed by intent — `[Explore]`, `[Grow]`,
  `[Hire]`, `[Promote]`, `[Sell]`, `[Data]` — so a client can group them. Not every
  tool carries a prefix; the groupings on this page are organized for readability.
</Tip>

## Explore — directory

| Tool                    | What it does                                           | Example prompt                                    |
| ----------------------- | ------------------------------------------------------ | ------------------------------------------------- |
| `search_directory`      | Search the public directory of regenerative businesses | "Find regenerative builders near Costa Rica."     |
| `get_business_profile`  | Fetch a single business profile by slug                | "Show me the profile for terralux-home."          |
| `get_ecosystem_network` | Return a business's network/relationship graph         | "Who is in TerraLux's ecosystem network?"         |
| `refer_business`        | Refer/nominate a business into the directory           | "Refer greenfield-kitchens.com to the directory." |
| `invite_owner_to_claim` | Send an owner an invite to claim a listing             | "Invite the owner of that listing to claim it."   |

## Grow — context

| Tool                              | What it does                                                                                        | Example prompt                                                         |
| --------------------------------- | --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| `get_business_context`            | Read the public Context Pack for a business                                                         | "Read the public context for terralux-home."                           |
| `get_business_context_private`    | Read full workspace context (org-scoped)                                                            | "Show our internal context modules."                                   |
| `get_context_pack`                | Fetch the compiled Context Pack (alias)                                                             | "Get the context pack for our business."                               |
| `resolve_context`                 | Check Context Pack readiness/metadata                                                               | "Is our context pack ready to publish?"                                |
| `create_business_context_section` | Add a custom context module                                                                         | "Add a 'Sustainability' section to our context."                       |
| `update_business_context_section` | Update a context module                                                                             | "Update our 'About' section with this copy."                           |
| `delete_business_context_section` | Remove a context module                                                                             | "Delete the outdated 'Pricing' section."                               |
| `compose_email`                   | **Composes and sends** an email via your connected Gmail (Mailgun fallback); threads into the Inbox | "Email an intro to [partner@example.com](mailto:partner@example.com)." |

## CRM & workspace

| Tool                    | What it does                  | Example prompt                                                          |
| ----------------------- | ----------------------------- | ----------------------------------------------------------------------- |
| `list_contacts`         | List CRM contacts             | "List my contacts tagged 'investor'."                                   |
| `create_contact`        | Create a CRM contact          | "Add Maria Lopez, [maria@fund.cr](mailto:maria@fund.cr), as a contact." |
| `list_tasks`            | List workspace tasks          | "What tasks are due this week?"                                         |
| `create_task`           | Create a task                 | "Create a task to follow up with David on Friday."                      |
| `get_workspace_summary` | Summarize the workspace state | "Give me a summary of my workspace."                                    |
| `get_onboarding_status` | Onboarding checklist progress | "What onboarding steps are left?"                                       |

## Prospect & go-to-market

| Tool                    | What it does                                                                                                                                                 | Example prompt                                       |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------- |
| `discover_prospects`    | Run the prospect-intelligence brain for your business — signal-based, scored prospects (ICP fit fused with live intent), each with a why-now and next action | "Find prospects ready to buy, ranked, with why-now." |
| `provision_gtm_profile` | Create a GTM profile from a domain                                                                                                                           | "Set up a GTM profile for 5dventures.com."           |
| `get_gtm_status`        | Check GTM profile + lead discovery status                                                                                                                    | "What's the status of my GTM profile?"               |
| `draft_gtm_emails`      | Draft personalized outreach for leads                                                                                                                        | "Draft outreach emails for my top 5 leads."          |

## Hire — recruiting

| Tool                         | What it does                          | Example prompt                                       |
| ---------------------------- | ------------------------------------- | ---------------------------------------------------- |
| `list_open_roles`            | List open recruiting roles            | "What roles are we hiring for?"                      |
| `create_recruit_role`        | Create a role                         | "Open a role for a regenerative landscape designer." |
| `update_recruit_role`        | Update a role                         | "Mark the designer role as remote."                  |
| `get_recruit_role`           | Fetch a role's detail                 | "Show the designer role details."                    |
| `discover_candidates`        | Source candidates for a role          | "Find candidates for the designer role."             |
| `search_recruit_pipeline`    | Search across the candidate pipeline  | "Search the pipeline for permaculture experience."   |
| `add_candidate_to_crm`       | Push a candidate into the CRM         | "Add that candidate to our CRM."                     |
| `draft_recruit_invitation`   | Draft a candidate invitation          | "Draft an invite for the top candidate."             |
| `get_public_careers`         | Read a business's public careers page | "Show TerraLux's public job listings."               |
| `post_role_to_linkedin`      | Post a role to LinkedIn Jobs          | "Post the designer role to LinkedIn."                |
| `update_recruit_application` | Update an inbound application         | "Move that applicant to 'interview'."                |
| `get_linkedin_talent_config` | Read LinkedIn Talent connector config | "Is LinkedIn Talent connected?"                      |

## Promote — affiliate

| Tool                          | What it does                            | Example prompt                         |
| ----------------------------- | --------------------------------------- | -------------------------------------- |
| `configure_affiliate_program` | Configure an affiliate/referral program | "Set up a 15% affiliate program."      |
| `get_affiliate_setup`         | Read affiliate program setup            | "Show our affiliate program settings." |

## Commerce & data

| Tool                   | What it does                          | Example prompt                             |
| ---------------------- | ------------------------------------- | ------------------------------------------ |
| `list_products`        | List storefront products              | "List our products."                       |
| `store_report`         | Storefront performance report         | "How did the store do last month?"         |
| `ads_report`           | Ad spend & ROAS report                | "What's our ad ROAS this quarter?"         |
| `query_public_records` | Query a registered public-data source | "Find recent building permits in Austin."  |
| `list_data_sources`    | List registered public-data sources   | "What data sources can I query?"           |
| `propose_data_source`  | Propose a new public-data source      | "Propose adding the Nextdoor data source." |

## Metering

| Tool                 | What it does                    | Example prompt              |
| -------------------- | ------------------------------- | --------------------------- |
| `get_wallet_balance` | Current credit balance & limits | "What's my credit balance?" |

See [Sample prompts](/mcp/sample-prompts) for multi-step workflows that chain these together.
