# Toolshed

## Docs

- [toolshed connect](https://docs.toolshed.philo.ventures/cli/connect.md): Link an OAuth provider to your Toolshed account.
- [toolshed login](https://docs.toolshed.philo.ventures/cli/login.md): Authenticate with the Toolshed server.
- [CLI Overview](https://docs.toolshed.philo.ventures/cli/overview.md): The Toolshed command-line interface.
- [toolshed run](https://docs.toolshed.philo.ventures/cli/run.md): Execute a TypeScript script in the Toolshed sandbox.
- [toolshed serve](https://docs.toolshed.philo.ventures/cli/serve.md): Start an MCP server over stdio for agent connections.
- [toolshed status](https://docs.toolshed.philo.ventures/cli/status.md): Show current authentication status and connected providers.
- [Architecture](https://docs.toolshed.philo.ventures/getting-started/architecture.md): Monorepo layout, package dependencies, and data flow.
- [Core Concepts](https://docs.toolshed.philo.ventures/getting-started/concepts.md): The building blocks of Toolshed -- tools, plugins, sources, roles, and elicitation.
- [Quickstart](https://docs.toolshed.philo.ventures/getting-started/quickstart.md): Get started with Toolshed in 5 minutes.
- [Adding Sources](https://docs.toolshed.philo.ventures/guides/adding-sources.md): Import tools from OpenAPI specs, GraphQL endpoints, MCP servers, and plugins.
- [Elicitation](https://docs.toolshed.philo.ventures/guides/elicitation.md): Human-in-the-loop approval for destructive tool calls.
- [OAuth Setup](https://docs.toolshed.philo.ventures/guides/oauth-setup.md): Configure OAuth providers and API key connections for Toolshed tools.
- [Policy and Roles](https://docs.toolshed.philo.ventures/guides/policy-and-roles.md): Control which tools each user can access with glob-pattern roles.
- [Web App](https://docs.toolshed.philo.ventures/guides/web-app.md): The Toolshed web dashboard for managing tools, authorizations, and MCP endpoints.
- [Writing Plugins](https://docs.toolshed.philo.ventures/guides/writing-plugins.md): Build a Toolshed plugin with definePlugin and defineTool.
- [Toolshed](https://docs.toolshed.philo.ventures/index.md): MCP server framework for AI agents with built-in consent, policy enforcement, and sandboxed execution.
- [call_tool](https://docs.toolshed.philo.ventures/mcp/call-tool.md): Execute one Toolshed tool by path. HTTP transport only.
- [MCP Server Overview](https://docs.toolshed.philo.ventures/mcp/overview.md): Two MCP transports (stdio for CLI, HTTP for remote) and the tools each one exposes.
- [read_tool](https://docs.toolshed.philo.ventures/mcp/read-tool.md): Get the full definition of a tool by its path.
- [resume](https://docs.toolshed.philo.ventures/mcp/resume.md): Approve or deny a pending elicitation to continue a suspended execution.
- [run](https://docs.toolshed.philo.ventures/mcp/run.md): Execute a TypeScript script in the Toolshed sandbox.
- [search_tools](https://docs.toolshed.philo.ventures/mcp/search-tools.md): Fuzzy search the tool catalog by keyword.
- [@toolshed/kernel](https://docs.toolshed.philo.ventures/packages/kernel.md): Runtime abstraction, elicitation engine, and tools proxy.
- [@toolshed/mcp-host](https://docs.toolshed.philo.ventures/packages/mcp-host.md): MCP server creation and hosting.
- [@toolshed/policy](https://docs.toolshed.philo.ventures/packages/policy.md): Authorization, role-based filtering, and annotation resolution.
- [@toolshed/sdk](https://docs.toolshed.philo.ventures/packages/sdk.md): Plugin and tool definition SDK.
- [@toolshed/shared](https://docs.toolshed.philo.ventures/packages/shared.md): Shared types, Zod schemas, and utility functions.
- [@toolshed/sources](https://docs.toolshed.philo.ventures/packages/sources.md): Data source adapters for OpenAPI, GraphQL, MCP, and plugins.
- [Attio Plugin](https://docs.toolshed.philo.ventures/plugins/attio.md): Attio CRM — manage objects, records, lists, notes, and tasks.
- [Browserbase Plugin](https://docs.toolshed.philo.ventures/plugins/browserbase.md): Browserbase cloud browser automation — create sessions, debug, record, and manage cloud browser instances.
- [Carta Plugin](https://docs.toolshed.philo.ventures/plugins/carta.md): Carta Investor API — portfolio holdings, cap tables, stakeholders, securities, and valuations.
- [Cloudflare Plugin](https://docs.toolshed.philo.ventures/plugins/cloudflare.md): Fetch web pages as clean markdown using Cloudflare's Markdown for Agents content negotiation.
- [DocuSign Plugin](https://docs.toolshed.philo.ventures/plugins/docusign.md): DocuSign eSignature — manage envelopes, templates, and recipients.
- [SEC EDGAR Plugin](https://docs.toolshed.philo.ventures/plugins/edgar.md): SEC EDGAR — search companies, browse filings (13F, 13D, Form D, S-1), full-text search, and XBRL financial data.
- [Firecrawl Plugin](https://docs.toolshed.philo.ventures/plugins/firecrawl.md): Firecrawl web scraping — scrape pages to markdown, search the web, extract structured data, and crawl sites.
- [GCP Plugin](https://docs.toolshed.philo.ventures/plugins/gcp.md): Google Cloud Platform — Compute Engine, Cloud Storage, BigQuery, IAM, and project management.
- [GitHub Plugin](https://docs.toolshed.philo.ventures/plugins/github.md): GitHub issues and repository operations.
- [Google Workspace Plugin](https://docs.toolshed.philo.ventures/plugins/google-workspace.md): Gmail, Google Calendar, and Google Drive operations.
- [Granola Plugin](https://docs.toolshed.philo.ventures/plugins/granola.md): Granola AI meeting notes — separate scoped tools for personal vs enterprise/team accounts.
- [Linear Plugin](https://docs.toolshed.philo.ventures/plugins/linear.md): Linear issue tracking operations.
- [Plugins Overview](https://docs.toolshed.philo.ventures/plugins/overview.md): Pre-built integrations for CRM, accounting, document signing, web search, cloud infrastructure, and more.
- [Perplexity Plugin](https://docs.toolshed.philo.ventures/plugins/perplexity.md): Web search powered by Perplexity Sonar — AI-synthesized answers with citations from live web data.
- [QuickBooks Plugin](https://docs.toolshed.philo.ventures/plugins/quickbooks.md): QuickBooks Online accounting — customers, invoices, bills, payments, vendors, accounts, and reports.
- [Slack Plugin](https://docs.toolshed.philo.ventures/plugins/slack.md): Slack messaging operations.
- [Environment Variables](https://docs.toolshed.philo.ventures/reference/environment-variables.md): All environment variables used by Toolshed.
- [PluginContext Reference](https://docs.toolshed.philo.ventures/reference/plugin-context.md): The five properties available to tool handlers.
- [Schema Reference](https://docs.toolshed.philo.ventures/reference/schemas.md): Complete Zod schema definitions used across Toolshed.
- [Tool Path Convention](https://docs.toolshed.philo.ventures/reference/tool-paths.md): Naming rules for tool paths and display names.
- [Audit Routes](https://docs.toolshed.philo.ventures/server/audit.md): Audit trail for tool invocations.
- [Auth Routes](https://docs.toolshed.philo.ventures/server/auth.md): Better Auth integration for user authentication and OAuth providers.
- [Connections API](https://docs.toolshed.philo.ventures/server/connections.md): CRUD API for tool connections and MCP endpoints with encrypted secret storage.
- [Connector Registry](https://docs.toolshed.philo.ventures/server/connectors.md): Server endpoint that reports which connectors have configured credentials.
- [Elicitation Routes](https://docs.toolshed.philo.ventures/server/elicitation.md): Store, poll, and resolve pending approval requests.
- [Server API Overview](https://docs.toolshed.philo.ventures/server/overview.md): The Toolshed REST API — auth, connections, tokens, registry, policy, audit, and elicitation.
- [Policy Routes](https://docs.toolshed.philo.ventures/server/policy.md): Role management and user access resolution.
- [Registry Routes](https://docs.toolshed.philo.ventures/server/registry.md): Tool catalog, source registration, search, and tool lookup.
- [Token Vending](https://docs.toolshed.philo.ventures/server/tokens.md): Resolve a credential for a tool plugin from connections, OAuth, or env vars.

## Optional

- [GitHub](https://github.com/Philo-Studio/toolshed)