API

The JSON API provides read-only access to community data without authentication and supports cross-origin requests.

Base URL

Endpoints

EndpointDescription
/api/companiesList companies
/api/companies/:slugGet company
/api/eventsList events
/api/events/:slugGet event
/api/groupsList groups
/api/groups/:slugGet group
/api/jobsList jobs
/api/jobs/:slugGet job
/api/educationList education
/api/education/:slugGet education
/api/newsList news
/api/news/:slugGet news article
/api/peopleList people
/api/people/:slugGet person
/api/projectsList projects
/api/projects/:slugGet project
/api/productsList products
/api/products/:slugGet product
/api/technologiesList technologies
/api/technologies/:slugGet technology

Pagination

List endpoints support pagination:

  • limit - Number of items (default: 20, max: 100)
  • offset - Items to skip (default: 0)

Responses include a pagination object:

{
  "data": [...],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}

Responses also include RFC 5988 Link headers for navigation:

Link: <https://siliconharbour.dev/api/companies?limit=20&offset=20>; rel="next",
      <https://siliconharbour.dev/api/companies?limit=20&offset=0>; rel="first"

OpenAPI specification

View OpenAPI Spec

MCP server

AI assistants and agents can connect to the MCP (Model Context Protocol) server at /mcp.

Endpoint: https://siliconharbour.dev/mcp

Tools

The server has two public tools and one authenticated tool. Expand a tool to see its available functions. This list comes from the bridge implementation and stays in sync with the server.

searchPublicexpand

Find operations by task, area, or field. Call this first to learn what data exists, then use query or execute to fetch it.

queryPublic21 functionsexpand

Execute restricted JavaScript in Code Mode to read SiliconHarbour data. Functions below are available through tools.siliconharbour. Each call hits the real database on-demand. Timeout: 10 seconds.

companies (2)
tools.siliconharbour.companyPublicGet(input: { "slug": string })
Get one public company by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use companyGet for operational fields.
tools.siliconharbour.companyPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "name" })
List public companies. Return a bounded page with optional text search. Hidden records are excluded. Administrators use companyList for moderation data.
education (2)
tools.siliconharbour.educationPublicGet(input: { "slug": string })
Get one public education by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use educationGet for operational fields.
tools.siliconharbour.educationPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "name" })
List public education. Return a bounded page with optional text search. Hidden records are excluded. Administrators use educationList for moderation data.
events (2)
tools.siliconharbour.eventPublicGet(input: { "slug": string })
Get one public event by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use eventGet for operational fields.
tools.siliconharbour.eventPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc"; "sort"?: "startDate"; "upcoming"?: boolean })
List public events. Return a bounded page with optional text search. Only publicly visible events are returned. upcoming defaults to true; false includes past events. Administrators use eventList for moderation data.
groups (2)
tools.siliconharbour.groupPublicGet(input: { "slug": string })
Get one public group by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use groupGet for operational fields.
tools.siliconharbour.groupPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "name" })
List public groups. Return a bounded page with optional text search. Follow the public directory visibility rules. Administrators use groupList for moderation data.
jobs (2)
tools.siliconharbour.jobPublicGet(input: { "slug": string })
Get one public job by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use jobGet for operational fields.
tools.siliconharbour.jobPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "postedAt" | "title" | "lastSeenAt"; "companyId"?: number; "sourceId"?: number; "status"?: "active"; "isTechnical"?: boolean; "workplaceType"?: "remote" | "onsite" | "hybrid"; "location"?: string; "lastSeenAfter"?: string })
List public jobs. Return a bounded page with optional text search. Only active jobs; no source credentials or private source URLs are returned. Administrators use jobList for moderation data.
news (2)
tools.siliconharbour.newsPublicGet(input: { "slug": string })
Get one public news by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use newsGet for operational fields.
tools.siliconharbour.newsPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "title" | "publishedAt" })
List public news. Return a bounded page with optional text search. Only published news is returned. Administrators use newsList for moderation data.
operations (1)
tools.siliconharbour.operationDescribe(input: { "name": string })
Describe an available operation and its contracts. Return input/output JSON Schemas, access, risk and examples for an operation available to this actor and scopes. No records are read. Use this inside a program after discovering a name.
people (2)
tools.siliconharbour.personPublicGet(input: { "slug": string })
Get one public person by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use personGet for operational fields.
tools.siliconharbour.personPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "name" })
List public people. Return a bounded page with optional text search. Hidden records are excluded. Administrators use personList for moderation data.
products (2)
tools.siliconharbour.productPublicGet(input: { "slug": string })
Get one public product by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use productGet for operational fields.
tools.siliconharbour.productPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "name" })
List public products. Return a bounded page with optional text search. Follow the public directory visibility rules. Administrators use productList for moderation data.
projects (2)
tools.siliconharbour.projectPublicGet(input: { "slug": string })
Get one public project by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use projectGet for operational fields.
tools.siliconharbour.projectPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "name" })
List public projects. Return a bounded page with optional text search. Follow the public directory visibility rules. Administrators use projectList for moderation data.
technologies (2)
tools.siliconharbour.technologyPublicGet(input: { "slug": string })
Get one public technology by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use technologyGet for operational fields.
tools.siliconharbour.technologyPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "name" })
List public technologies. Return a bounded page with optional text search. Hidden records are excluded. Administrators use technologyList for moderation data.
executeAuthenticated233 functionsexpand

Read data and run admin operations. Requires an OAuth-authorized MCP session with the mcp:write scope. Timeout: 60 seconds.

blocklist (8)
tools.siliconharbour.blocklistAdd(input: { "source": "github" | "technl" | "genesis" | "bounce"; "externalId": string; "name": string; "reason"?: string | null; "deleteExisting"?: boolean; "confirm": true })
Block an identity from future imports. Normalize the source key and persist the block before optional deletion of matching stored records. deleteExisting removes matching people, companies, or education institutions and unreferenced images. Existing blocks keep their name, reason and date; use blocklistUpdate to edit metadata. Requires confirm: true.
tools.siliconharbour.blocklistAddMany(input: { "items": Array<{ "source": "github" | "technl" | "genesis" | "bounce"; "externalId": string; "name": string; "reason"?: string | null; "deleteExisting"?: boolean }>; "confirm": true })
Block selected import identities. Apply blocklistAdd to at most 200 items in input order. Each item normalizes its key, preserves existing block metadata, and can explicitly delete existing matches. Return per-item results and continue after failures. Requires confirm: true.
tools.siliconharbour.blocklistList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "blockedAt" | "name" | "key"; "source"?: "github" | "technl" | "genesis" | "bounce" })
List blocked import identities. Return a bounded page for a selected source or all directory/GitHub sources. Keys use the same normalization as importers.
tools.siliconharbour.blocklistRemove(input: { "source": "github" | "technl" | "genesis" | "bounce"; "externalId": string })
Remove an import block. Normalize the key, remove its matching block, and allow later imports. Does not recreate a deleted record.
tools.siliconharbour.blocklistUpdate(input: { "id": number; "name"?: string; "reason"?: string | null })
Edit a blocked identity's name or reason. Patch name or reason by blocklist row ID. Omitted fields stay unchanged; null or blank clears the reason. The identity and original block date stay unchanged. Throws NotFound for a missing row.
tools.siliconharbour.rejectedRecordDelete(input: { "id": number; "confirm": true })
Permanently delete a rejected record. Delete a retained person or company and its dependent relationships, cleaning up unreferenced images. Its import block remains. This also cleans up expired entries. Requires confirm: true.
tools.siliconharbour.rejectedRecordList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "rejectedAt" | "expiresAt" | "name"; "type"?: "person" | "company" })
List rejected directory records. List retained people and companies, including expired entries awaiting cleanup. Records stay hidden and outside normal directory and review reads. Restore within seven days, or permanently delete with rejectedRecordDelete.
tools.siliconharbour.rejectedRecordRestore(input: { "id": number; "confirm": true })
Restore a rejected directory record. Restore within seven days using the server-held record, preserving its ID, slug, fields, images and relationships. Restore its previous visibility and remove its import block unless another retained rejection uses that key. Requires confirm: true. Expired entries return NotFound.
comments (2)
tools.siliconharbour.commentDelete(input: { "id": number; "confirm": true })
Delete a comment. Permanently remove the comment using the shared moderation service. Requires confirm: true.
tools.siliconharbour.commentList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "authorName"; "contentType"?: "event" | "company" | "group" | "education" | "person" | "news" | "job" | "project" | "product"; "contentId"?: number; "createdAfter"?: string; "createdBefore"?: string })
List comments for moderation. Return a bounded page including private comments and moderation metadata. This data is administrator-only.
companies (14)
tools.siliconharbour.companyApprove(input: { "id": number })
Approve a company for public display. Set visible to true. Use companyUnapprove to hide it without deletion.
tools.siliconharbour.companyConvertToEducation(input: { "id": number; "institutionType": "university" | "college" | "bootcamp" | "online" | "other"; "confirm": true })
Convert a company into an education institution. Create an institution using the company data and selected institution type, then remove the company using the existing conversion service. Requires confirm: true.
tools.siliconharbour.companyCreate(input: { "technologyIds"?: Array<number>; "evidenceGroups"?: Array<{ "technologyIds": Array<number>; "sourceType"?: "job_posting" | "survey" | "manual"; "sourceKey"?: "job_postings" | "get_coding_reference"; "sourceUrl"?: string | null; "lastVerified"?: string | null; "excerptText"?: string | null; "jobIds"?: Array<number> }>; "name": string; "description": string; "website"?: string | null; "externalLinks"?: { "github"?: string | null; "wikipedia"?: string | null; "twitter"?: string | null; "linkedin"?: string | null; "instagram"?: string | null; "youtube"?: string | null; "mastodon"?: string | null; "bluesky"?: string | null; "facebook"?: string | null } | null; "careersUrl"?: string | null; "email"?: string | null; "location"?: string | null; "founded"?: string | null; "visible"?: boolean; "technl"?: boolean; "genesis"?: boolean; "bounce"?: boolean; "newsFilterInclude"?: boolean; "logo"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "coverImage"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "ifNotExists"?: boolean })
Create a company. Create the record through the shared service, derive its slug, and synchronize references. Optional images support upload, public URL, data URL, keep, or clear. New records default to hidden until approved. Set ifNotExists to return an existing record by canonical website, or GitHub organization profile. Existing records are unchanged and return created:false; new records return created:true.
tools.siliconharbour.companyDelete(input: { "id": number; "confirm": true; "block"?: { "source": "technl" | "genesis" | "bounce"; "reason"?: string | null } })
Delete a company, optionally blocking a directory source. Use the stored website or lowercased name as the import key. Block before deletion and clean up unreferenced images. Optional block.reason explains a new block; existing block metadata is preserved. Requires confirm: true.
tools.siliconharbour.companyGet(input: { "id"?: number; "slug"?: string; "name"?: string })
Get one company. Return the stored record including hidden fields for administration. Throws when the record does not exist.
tools.siliconharbour.companyHideAllVisible(input: { "confirm": true })
Hide all visible companies. Preserve company records and images while hiding their directory listings. Requires confirm: true.
tools.siliconharbour.companyList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "name" | "createdAt" | "updatedAt"; "visible"?: boolean; "hasJobSource"?: boolean; "missing"?: "logo" | "linkedin" | "location" | "founded" | "careers" | "no-source" })
List companies for administration. Return a bounded page including hidden records. Filter by query or visibility. Use companyGet for one record.
tools.siliconharbour.companyPublicGet(input: { "slug": string })
Get one public company by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use companyGet for operational fields.
tools.siliconharbour.companyPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "name" })
List public companies. Return a bounded page with optional text search. Hidden records are excluded. Administrators use companyList for moderation data.
tools.siliconharbour.companyReject(input: { "id": number; "confirm": true; "reason"?: string | null })
Reject a company from the review queue. Block the stored import identity when present and retain the record for seven days, hidden from the directory and review queues. Preserve images, ID, slug and relationships. Optional reason describes a new block; existing block metadata is preserved. Use rejectedRecordRestore with restoreId to undo, or rejectedRecordDelete to permanently remove it. Requires confirm: true.
tools.siliconharbour.companyTechnologiesSet(input: { "id": number; "technologyIds": Array<number> })
Replace a company's technology assignments. Assign exactly technologyIds; an empty array clears the stack. Every technology must exist. Removed assignments also remove their evidence.
tools.siliconharbour.companyTechnologyEvidenceSet(input: { "id": number; "groups": Array<{ "technologyIds": Array<number>; "sourceType"?: "job_posting" | "survey" | "manual"; "sourceKey"?: "job_postings" | "get_coding_reference"; "sourceUrl"?: string | null; "lastVerified"?: string | null; "excerptText"?: string | null; "jobIds"?: Array<number> }> })
Replace evidence for a company's technology stack. Use groups of assigned technology IDs with provenance, verification dates, excerpts, and job IDs. A sourceKey resolves the same provenance defaults used by admin; an explicit sourceType can also be supplied. Empty groups clear evidence.
tools.siliconharbour.companyUnapprove(input: { "id": number })
Hide an approved company. Set visible to false while preserving the record and its images.
tools.siliconharbour.companyUpdate(input: { "id": number; "technologyIds"?: Array<number>; "evidenceGroups"?: Array<{ "technologyIds": Array<number>; "sourceType"?: "job_posting" | "survey" | "manual"; "sourceKey"?: "job_postings" | "get_coding_reference"; "sourceUrl"?: string | null; "lastVerified"?: string | null; "excerptText"?: string | null; "jobIds"?: Array<number> }>; "name"?: string; "description"?: string; "website"?: string | null; "externalLinks"?: { "github"?: string | null; "wikipedia"?: string | null; "twitter"?: string | null; "linkedin"?: string | null; "instagram"?: string | null; "youtube"?: string | null; "mastodon"?: string | null; "bluesky"?: string | null; "facebook"?: string | null } | null; "careersUrl"?: string | null; "email"?: string | null; "location"?: string | null; "founded"?: string | null; "visible"?: boolean; "technl"?: boolean; "genesis"?: boolean; "bounce"?: boolean; "newsFilterInclude"?: boolean; "logo"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "coverImage"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true } })
Update a company. Patch only supplied fields; empty patches and unknown keys fail. externalLinks merges supplied keys; a null key removes that link, and a null object clears all links. Renaming regenerates the slug and text changes synchronize references. Replaced or cleared images are removed only when unreferenced.
config (4)
tools.siliconharbour.siteCommentVisibilitySet(input: { "values": { "companies"?: boolean; "groups"?: boolean; "education"?: boolean; "projects"?: boolean; "products"?: boolean; "news"?: boolean } })
Change comment visibility by content type. Patch supplied comment flags without deleting comments.
tools.siliconharbour.siteConfigGet(input: { })
Get site visibility and configuration. Return section/comment visibility and global news keywords. Discord credentials are masked and never returned in full.
tools.siliconharbour.siteConfigSave(input: { "sections"?: { "events"?: boolean; "companies"?: boolean; "groups"?: boolean; "projects"?: boolean; "products"?: boolean; "education"?: boolean; "people"?: boolean; "news"?: boolean; "jobs"?: boolean }; "comments"?: { "companies"?: boolean; "groups"?: boolean; "education"?: boolean; "projects"?: boolean; "products"?: boolean; "news"?: boolean }; "newsGlobalKeywords"?: Array<string> | null; "botToken"?: string | null; "confirm": true })
Save supplied site settings. Atomically patch supplied section/comment flags, global news keywords and the Discord token. Omitted fields keep their current values; null clears keywords or the token. Return only masked Discord configuration. Prefer siteSectionVisibilitySet, siteCommentVisibilitySet or newsGlobalKeywordsSet for a single change. Requires confirm: true.
tools.siliconharbour.siteSectionVisibilitySet(input: { "values": { "events"?: boolean; "companies"?: boolean; "groups"?: boolean; "projects"?: boolean; "products"?: boolean; "education"?: boolean; "people"?: boolean; "news"?: boolean; "jobs"?: boolean } })
Change public section visibility. Patch supplied section flags. False hides that section's public content without deleting it.
dashboard (2)
tools.siliconharbour.dashboardCounts(input: { })
Get admin dashboard counts. Return entity counts, pending-review totals, and failed import sources to guide moderation.
tools.siliconharbour.reviewQueueList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "title" })
Get pending events, news, and jobs. Return the unified administrator review queue. Use the corresponding eventImportApprove, newsApprove, or jobApprove operation to review an item.
discord (15)
tools.siliconharbour.discordChannelsList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "name"; "guildId": string })
List postable Discord channels for a guild. Read live channel permissions using the stored bot token. Include channels the bot cannot send to with a reason.
tools.siliconharbour.discordConfigGet(input: { })
Get masked Discord configuration. Report whether a bot token is configured and its masked suffix. The credential itself is never returned.
tools.siliconharbour.discordConfigSet(input: { "confirm": true; "botToken": string | null })
Replace the Discord bot token. Store the supplied token, or clear it with null. Return only masked configuration. Does not contact Discord. Requires confirm: true because the old token cannot be read back.
tools.siliconharbour.discordDestinationAdd(input: { "type": "events" | "jobs"; "guildId": string; "guildName": string; "channelId": string; "channelName": string })
Add a Discord posting destination. Store a guild/channel destination. Re-adding the same type/channel refreshes its display names. Does not post a message.
tools.siliconharbour.discordDestinationList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "name"; "type": "events" | "jobs" })
List Discord posting destinations. Return configured guild/channel destinations for event or job roundups. This reads stored configuration only.
tools.siliconharbour.discordDestinationRemove(input: { "id": number; "confirm": true })
Remove a Discord destination. Remove the stored destination without deleting posted messages or history. Requires confirm: true.
tools.siliconharbour.discordGuildsList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "name" })
List the bot's Discord guilds. Read live Discord guild IDs and names using the stored bot token. No credentials are returned.
tools.siliconharbour.discordPost(input: { "type": "events" | "jobs"; "itemIds": Array<number>; "introText"?: string | null; "confirm": true })
Post an event or job roundup to Discord. Require selected items to remain eligible, build the site's messages, post all chunks to each configured destination, and record successful destinations as one batch. Return partial destination failures for review. Requires confirm: true.
tools.siliconharbour.discordPostHistory(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "postedAt"; "type": "events" | "jobs" })
List Discord posting history by batch. Return recent stored batches with destination message IDs, item counts, and skipped counts. No Discord request runs.
tools.siliconharbour.discordSkip(input: { "type": "events" | "jobs"; "itemIds": Array<number> })
Skip items in the Discord queue. Record eligible event/job IDs as skipped so they no longer appear in the unposted queue. No Discord request runs.
tools.siliconharbour.discordSkipOld(input: { })
Skip Discord jobs older than a week. Use postedAt, then firstSeenAt, then createdAt against the operation clock. Record old unposted jobs as skipped without contacting Discord.
tools.siliconharbour.discordTest(input: { "token"?: string; "confirm": true })
Test the Discord bot token. Verify a supplied token, or the stored token when omitted, and report the bot identity and guild count. No token is included in the output. Requires confirm: true.
tools.siliconharbour.discordUndo(input: { "id": number; "confirm": true })
Undo tracking for one Discord post. Remove the stored post record. Items are requeued only when that record owns them; use discordUndoBatch for an entire fan-out. Preserve existing admin behavior: actual Discord messages remain in their channels. Requires confirm: true.
tools.siliconharbour.discordUndoBatch(input: { "batchId": string; "confirm": true })
Undo tracking for an entire Discord batch. Remove all stored post rows in the batch and requeue their items. This follows the existing admin action and leaves actual Discord messages in place. Requires confirm: true.
tools.siliconharbour.discordUnpostedList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "title"; "type": "events" | "jobs" })
List items awaiting a Discord roundup. Return eligible public events or active jobs not already posted or skipped. Event records retain recurrence fields for message generation.
education (7)
tools.siliconharbour.educationCreate(input: { "name": string; "description": string; "type"?: "university" | "college" | "bootcamp" | "online" | "other"; "website"?: string | null; "technl"?: boolean; "genesis"?: boolean; "bounce"?: boolean; "visible"?: boolean; "logo"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "coverImage"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "ifNotExists"?: boolean })
Create a education. Create the record through the shared service, derive its slug, and synchronize references. Optional images support upload, public URL, data URL, keep, or clear. New records default to hidden until approved. Set ifNotExists to return an existing record by canonical website. Existing records are unchanged and return created:false; new records return created:true.
tools.siliconharbour.educationDelete(input: { "id": number; "confirm": true })
Delete a education. Delete the record and clean up unreferenced images. Requires confirm: true. Returns the deleted record for review history.
tools.siliconharbour.educationGet(input: { "id"?: number; "slug"?: string; "name"?: string })
Get one education. Return the stored record including hidden fields for administration. Throws when the record does not exist.
tools.siliconharbour.educationList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "name" | "createdAt" | "updatedAt"; "visible"?: boolean })
List education for administration. Return a bounded page including hidden records. Filter by query or visibility. Use educationGet for one record.
tools.siliconharbour.educationPublicGet(input: { "slug": string })
Get one public education by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use educationGet for operational fields.
tools.siliconharbour.educationPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "name" })
List public education. Return a bounded page with optional text search. Hidden records are excluded. Administrators use educationList for moderation data.
tools.siliconharbour.educationUpdate(input: { "id": number; "name"?: string; "description"?: string; "type"?: "university" | "college" | "bootcamp" | "online" | "other"; "website"?: string | null; "technl"?: boolean; "genesis"?: boolean; "bounce"?: boolean; "visible"?: boolean; "logo"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "coverImage"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true } })
Update a education. Patch only supplied fields; empty patches and unknown keys fail. Renaming regenerates the slug and text changes synchronize references. Replaced or cleared images are removed only when unreferenced.
events (29)
tools.siliconharbour.eventCreate(input: { "title": string; "description": string; "link"?: string | null; "location"?: string | null; "organizer"?: string | null; "requiresSignup"?: boolean; "timeMode"?: "scheduled" | "period"; "parentEventId"?: number | null; "iconImage"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "coverImage"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "coverImageUrl"?: string | null; "importStatus"?: "pending_review" | "approved" | "published" | "hidden" | "removed" | null; "dates"?: Array<{ "startDate": string | string; "endDate"?: string | string | null; "startTime"?: string; "endTime"?: string; "isAllDay"?: boolean }>; "tagIds"?: Array<number>; "eventTags"?: Array<string>; "recurrenceRule"?: string; "recurrenceStart"?: string | string | null; "recurrenceEnd"?: string | string | null; "defaultStartTime"?: string | null; "defaultEndTime"?: string | null; "ifNotExists"?: boolean })
Create an event with dates or recurrence. Supply explicit dates or a recurrence rule with defaultStartTime. All-day dates anchor to noon in America/St_Johns. Defaults to pending_review; importStatus null or published makes it public. Images are prepared before saving, and references and tags are synchronized. Set ifNotExists to return an existing record by canonical link, parent event and normalized schedule. Existing records are unchanged and return created:false; new records return created:true.
tools.siliconharbour.eventDelete(input: { "id": number; "confirm": true })
Delete an event. Remove the event, dates, occurrence overrides and tag assignments; clean up unreferenced images. Requires confirm: true.
tools.siliconharbour.eventGet(input: { "id"?: number; "slug"?: string; "name"?: string })
Get an event and its occurrence overrides. Look up an event by ID, slug, or exact title. Includes unpublished records, dates, tags, recurrence fields, and overrides.
tools.siliconharbour.eventImportApprove(input: { "id": number })
Approve an imported event for editing. Set importStatus to approved. This does not publish; call eventPublish. If no cover exists, fetch the stored coverImageUrl through the public-address image guard. Download failure does not block approval; coverPulled reports the outcome.
tools.siliconharbour.eventImportBulkApprove(input: { "ids": Array<number> })
Approve selected imported events. Set importStatus to approved. This does not publish; call eventPublish. If no cover exists, fetch the stored coverImageUrl through the public-address image guard. Download failure does not block approval; coverPulled reports the outcome. Apply to at most 200 distinct IDs in input order, using the same single-record operation. Return a result for each ID and continue after failures.
tools.siliconharbour.eventImportBulkHide(input: { "ids": Array<number>; "confirm": true })
Hide selected events. Unpublish a public or imported event by setting importStatus to hidden, preserving dates, recurrence, images and overrides. Use eventImportUnhide to return it to review, or eventPublish to publish. Apply to at most 200 distinct IDs in input order, using the same single-record operation. Return a result for each ID and continue after failures. Requires confirm: true.
tools.siliconharbour.eventImportHide(input: { "id": number })
Hide an event. Unpublish a public or imported event by setting importStatus to hidden, preserving dates, recurrence, images and overrides. Use eventImportUnhide to return it to review, or eventPublish to publish.
tools.siliconharbour.eventImportUnhide(input: { "id": number })
Return a hidden imported event to review. Set importStatus to pending_review. It remains hidden from the public until eventPublish.
tools.siliconharbour.eventList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "title"; "importStatus"?: "pending_review" | "approved" | "published" | "hidden" | "removed" | null; "sourceId"?: number | null })
List events including unpublished records. Filter by title, import status, or source and return a bounded page with dates and tags. Use eventGet for recurrence overrides.
tools.siliconharbour.eventOccurrenceCancel(input: { "id": number; "date": string | string })
Cancel one occurrence of a recurring event. Set the cancellation override for the specified Newfoundland calendar day. Other occurrences are unchanged. Use eventOccurrenceUncancel to restore it.
tools.siliconharbour.eventOccurrenceClearOverride(input: { "id": number; "overrideId": number })
Remove an occurrence override. Remove only an override owned by this event. The day returns to the series schedule and defaults, including cancellation state.
tools.siliconharbour.eventOccurrencesGet(input: { "id": number; "from"?: string; "until"?: string })
Get generated event occurrences and overrides. Return occurrences within a bounded date range, including cancelled instances. Defaults to the past week through the next 90 days. Dates use America/St_Johns recurrence rules.
tools.siliconharbour.eventOccurrenceUncancel(input: { "id": number; "date": string | string })
Restore a cancelled event occurrence. Set cancelled to false while preserving location, time, and description overrides for this day.
tools.siliconharbour.eventOccurrenceUpdate(input: { "id": number; "date": string | string; "location"?: string | null; "description"?: string | null; "link"?: string | null; "startTime"?: string | null; "endTime"?: string | null })
Change one recurring event occurrence. Patch the location, description, link, or HH:mm start/end times for one day in America/St_Johns. Null restores an inherited field. Use eventUpdate to change the whole series.
tools.siliconharbour.eventPeriodOptionsList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "title"; "excludeId"?: number })
List parent periods for event forms. Return eligible period IDs and titles, optionally excluding the event being edited.
tools.siliconharbour.eventPublicGet(input: { "slug": string })
Get one public event by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use eventGet for operational fields.
tools.siliconharbour.eventPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc"; "sort"?: "startDate"; "upcoming"?: boolean })
List public events. Return a bounded page with optional text search. Only publicly visible events are returned. upcoming defaults to true; false includes past events. Administrators use eventList for moderation data.
tools.siliconharbour.eventPublish(input: { "id": number })
Publish an event. Set importStatus to published so the event appears publicly. Approval alone does not publish.
tools.siliconharbour.eventSourceCreate(input: { "name": string; "organizer"?: string | null; "sourceType": "luma-user" | "luma-calendar" | "technl" | "netbenefit" | "eventbrite" | "bevy" | "meetup"; "sourceIdentifier": string; "sourceUrl": string; "confirm": true; "ifNotExists"?: boolean })
Validate and create an event import source. Validate configuration using the selected importer, which may fetch the source. Store the source without importing events. Requires confirm: true. Use eventSourceSync to import. Set ifNotExists to return an existing record by source type and provider identifier. Existing records are unchanged and return created:false; new records return created:true.
tools.siliconharbour.eventSourceDelete(input: { "id": number; "confirm": true })
Delete an event import source. Delete pending, hidden, and removed imported events and their images. Preserve approved/published events and detach their source. Requires confirm: true.
tools.siliconharbour.eventSourceGet(input: { "id": number })
Get an import source and its review records. Return source configuration, lifecycle groups and review data for administrators. Throws when the source does not exist. Use the entity list for filtered pages.
tools.siliconharbour.eventSourceList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "name" })
List event import sources. Return source configuration, fetch status, and pending/published event counts.
tools.siliconharbour.eventSourceSync(input: { "id": number; "confirm": true; "async"?: boolean })
Sync one event import source. Fetch live source data and update imported events. Requires confirm: true. Set async to return a run ID immediately; poll asyncSyncGet.
tools.siliconharbour.eventSourceSyncAll(input: { "confirm": true; "async"?: boolean })
Sync all event import sources. Fetch each configured source in the existing source order. Requires confirm: true. Set async to return a run ID and poll asyncSyncGet.
tools.siliconharbour.eventSourceUpdate(input: { "id": number; "name"?: string; "organizer"?: string | null; "sourceIdentifier"?: string; "sourceUrl"?: string })
Update event source configuration. Patch name, organizer, identifier, or URL. The importer type is fixed at creation. No live sync runs.
tools.siliconharbour.eventTagDelete(input: { "id": number; "confirm": true })
Delete an event tag. Remove the tag and all its assignments without deleting events. Requires confirm: true.
tools.siliconharbour.eventTagList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "name" })
List event tags and usage counts. Return available tag names, slugs, palette colors, and the number of assigned events.
tools.siliconharbour.eventTagSave(input: { "id"?: number; "name": string; "color": "harbour" | "green" | "amber" | "red" | "purple" })
Create or rename an event tag. Omit id to create; supply id to update. Derive the slug from name and reject duplicate names. Existing event assignments are preserved.
tools.siliconharbour.eventUpdate(input: { "id": number; "title"?: string; "description"?: string; "link"?: string | null; "location"?: string | null; "organizer"?: string | null; "requiresSignup"?: boolean; "timeMode"?: "scheduled" | "period"; "parentEventId"?: number | null; "iconImage"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "coverImage"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "coverImageUrl"?: string | null; "importStatus"?: "pending_review" | "approved" | "published" | "hidden" | "removed" | null; "dates"?: Array<{ "startDate": string | string; "endDate"?: string | string | null; "startTime"?: string; "endTime"?: string; "isAllDay"?: boolean }>; "tagIds"?: Array<number>; "eventTags"?: Array<string>; "recurrenceRule"?: string; "recurrenceStart"?: string | string | null; "recurrenceEnd"?: string | string | null; "defaultStartTime"?: string | null; "defaultEndTime"?: string | null })
Update event details or switch its schedule. Patch supplied fields. Supplying dates clears all five recurrence fields; supplying a recurrence rule clears explicit dates. Do not combine dates and recurrence fields. Stored occurrence overrides survive schedule changes and are ignored while one-time. Use eventOccurrenceUpdate to edit one occurrence. Images, slugs, tags, and references follow the shared service.
export (1)
tools.siliconharbour.siteExport(input: { })
Prepare a site export download. Return a single-use download URL for the admin ZIP export, valid for five minutes. The URL grants download access; keep it private. Generate the export on redemption without fetching user-supplied URLs. Requires write scope because it grants access to the full private dataset.
groups (7)
tools.siliconharbour.groupCreate(input: { "name": string; "description": string; "website"?: string | null; "meetingFrequency"?: string | null; "visible"?: boolean; "logo"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "coverImage"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "ifNotExists"?: boolean })
Create a group. Create the record through the shared service, derive its slug, and synchronize references. Optional images support upload, public URL, data URL, keep, or clear. New records default to hidden until approved. Set ifNotExists to return an existing record by canonical website. Existing records are unchanged and return created:false; new records return created:true.
tools.siliconharbour.groupDelete(input: { "id": number; "confirm": true })
Delete a group. Delete the record and clean up unreferenced images. Requires confirm: true. Returns the deleted record for review history.
tools.siliconharbour.groupGet(input: { "id"?: number; "slug"?: string; "name"?: string })
Get one group. Return the stored record including hidden fields for administration. Throws when the record does not exist.
tools.siliconharbour.groupList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "name" | "createdAt" | "updatedAt"; "visible"?: boolean })
List groups for administration. Return a bounded page including hidden records. Filter by query or visibility. Use groupGet for one record.
tools.siliconharbour.groupPublicGet(input: { "slug": string })
Get one public group by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use groupGet for operational fields.
tools.siliconharbour.groupPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "name" })
List public groups. Return a bounded page with optional text search. Follow the public directory visibility rules. Administrators use groupList for moderation data.
tools.siliconharbour.groupUpdate(input: { "id": number; "name"?: string; "description"?: string; "website"?: string | null; "meetingFrequency"?: string | null; "visible"?: boolean; "logo"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "coverImage"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true } })
Update a group. Patch only supplied fields; empty patches and unknown keys fail. Renaming regenerates the slug and text changes synchronize references. Replaced or cleared images are removed only when unreferenced.
images (8)
tools.siliconharbour.imageAttach(input: { "type": "event" | "company" | "group" | "person" | "education" | "project" | "product" | "news" | "technology"; "id": number; "role": "cover" | "icon"; "uploadId": string; "confirm": true })
Attach a prepared image upload. Consume a ready, single-use upload and replace the entity image. Failed attachments preserve the upload for retry; replaced files are removed only when unreferenced. Requires confirm: true.
tools.siliconharbour.imageClear(input: { "type": "event" | "company" | "group" | "person" | "education" | "project" | "product" | "news" | "technology"; "id": number; "role": "cover" | "icon"; "confirm": true })
Clear an entity image. Remove the stored cover/icon reference and delete its file when no other entity uses it. Requires confirm: true.
tools.siliconharbour.imageOrphanDelete(input: { "path": string; "confirm": true })
Delete one staged orphan image. Recheck references and delete only a staged, unreferenced image. Paths are restricted to the staged images directory. Requires confirm: true.
tools.siliconharbour.imageOrphansDeleteAll(input: { "confirm": true })
Delete all staged orphan images. Recheck references for every staged image and preserve newly referenced files. Requires confirm: true.
tools.siliconharbour.imageOrphansList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "stagedAt" | "filename" | "sizeBytes" })
List staged orphan images. Return paginated staged files, total bytes, scan cursor, and report count. No scan or deletion runs.
tools.siliconharbour.imageOrphansStage(input: { "batchSize"?: number; "resetCursor"?: boolean; "dryRun"?: boolean })
Scan and stage a batch of orphan images. Check a bounded batch against database references, persist the cursor and report, and stage unreferenced files. Does not delete images. dryRun avoids updating cursor/staging state.
tools.siliconharbour.imageSetFromUrl(input: { "type": "event" | "company" | "group" | "person" | "education" | "project" | "product" | "news" | "technology"; "id": number; "role": "cover" | "icon"; "url": string; "confirm": true })
Set an entity image from a public URL. Fetch a public HTTPS image through the address guard, validate its bytes and dimensions, and save WebP. Clean up the previous file when unreferenced. Review/visibility status does not change. Requires confirm: true.
tools.siliconharbour.imageUploadPrepare(input: { "filename"?: string; "contentType": "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/avif"; "size": number })
Prepare a single-use image upload. Reserve a 10-minute upload slot for a static image of at most 5 MiB and 16 megapixels. Outside the sandbox: curl --request PUT --header "Authorization: Bearer <returned token>" --header "Content-Type: <returned content type>" --data-binary @image.png "<uploadUrl>". Use the returned upload-only headers exactly, then call imageAttach with confirm: true. A {kind:"dataUrl",dataUrl,confirm:true} image field is the in-sandbox alternative. Do not log upload tokens.
importers (24)
tools.siliconharbour.asyncSyncGet(input: { "id": string })
Get an asynchronous import sync run. Poll a process-local run ID for current step, lifecycle counts, per-source results, or errors. The registry holds at most 20 runs, including active runs; old finished runs may be evicted. All run IDs disappear on server restart. A missing ID does not prove that no writes happened: inspect source results before explicitly retrying.
tools.siliconharbour.asyncSyncList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "startedAt" | "status" })
List recent asynchronous sync runs. Return process-local sync runs newest first. These include operational error details and are administrator-only.
tools.siliconharbour.directoryImport(input: { "source": "technl" | "genesis" | "bounce"; "companies": Array<{ "name": string; "description"?: string | null; "website"?: string | null; "email"?: string | null; "logoUrl"?: string | null; "categories"?: Array<string>; "sourceUrl"?: string; "sourceId"?: string }>; "downloadLogos"?: boolean })
Import reviewed directory companies. Skip normalized blocklist identities. Existing companies gain the source flag without overwriting curated data; new companies are hidden. Optional logos use the public image guard. Return per-company results and errors.
tools.siliconharbour.directoryImportAdoptField(input: { "source": "technl" | "genesis" | "bounce"; "name": string; "companyWebsite"?: string | null; "field": "website" | "description" | "email"; "value": string })
Adopt a reviewed company field from a directory. Find the company by name or fallback website, then update only website, description, or email through the shared company service. Synchronize references and preserve other curated fields.
tools.siliconharbour.directoryImportFetch(input: { "source": "technl" | "genesis" | "bounce"; "confirm": true })
Fetch a company directory for review. Scrape the fixed TechNL, Genesis, or Bounce source and return candidates, dropped memberships, and possible rename matches without writing anything. Empty or suspiciously small results return a warning instead of removals. Requires confirm: true.
tools.siliconharbour.directoryImportReviewGet(input: { "source": "technl" | "genesis" | "bounce" })
Get directory review matches and blocklist keys. Return existing identities and field values for comparing directory candidates. Includes hidden records; no scraping runs.
tools.siliconharbour.directorySourceFlagsClear(input: { "source": "technl" | "genesis" | "bounce"; "entities": Array<{ "type": "company" | "education"; "id": number }>; "confirm": true })
Clear reviewed directory membership flags. Clear only the selected company's or institution's flag for one source. Preserve other memberships, visibility and historical last-seen metadata. Never delete records. Requires confirm: true.
tools.siliconharbour.directorySourceReconcile(input: { "source": "technl" | "genesis" | "bounce"; "confirm": true })
Record directory matches from a fresh source fetch. Fetch the full source and record IDs and last-seen timestamps for unambiguous existing matches. Never create records or change membership flags. Reject removal review for empty or suspiciously small scrapes. Requires confirm: true.
tools.siliconharbour.githubFollowingContinue(input: { "runId": string; "confirm": true })
Fetch the next GitHub connection profile batch. Advance the active job and checkpoint each profile. Concurrent batch requests fail instead of replaying. This gathers profiles without creating people. Requires confirm: true.
tools.siliconharbour.githubFollowingImport(input: { "users": Array<{ "login": string; "id": number; "avatar_url": string; "html_url": string; "name": string | null; "company": string | null; "bio": string | null; "blog": string | null; "location": string | null; "public_repos": number; "twitter_username": string | null }>; "downloadAvatars"?: boolean })
Import reviewed GitHub connection profiles. Skip blocklisted or existing identities and create hidden people. Synchronize company references and optionally download avatars through the public image guard. Return per-profile results.
tools.siliconharbour.githubFollowingPause(input: { "runId": string })
Pause a GitHub connection job. Wait for the active batch to finish, then pause and retain fetched profiles.
tools.siliconharbour.githubFollowingReset(input: { "runId": string; "confirm": true })
Reset a GitHub connection import job. Wait for the active batch to finish, then clear progress and fetched profiles without deleting people already imported. Requires confirm: true.
tools.siliconharbour.githubFollowingResume(input: { "runId": string; "confirm": true })
Resume a paused GitHub connection job. Resume the existing following/follower job and its live GitHub work. Requires confirm: true.
tools.siliconharbour.githubFollowingStart(input: { "username": string; "mode"?: "following" | "followers" | "both"; "confirm": true })
Start fetching a user's GitHub connections. Fetch following, followers, or both for username and initialize the existing import job. Requires confirm: true. Continue in batches and poll githubFollowingStatus.
tools.siliconharbour.githubFollowingStatus(input: { })
Get GitHub connection import progress and profiles. Read persisted run identity, pause reason, queue progress and fetched profiles without advancing the job. Profiles survive server restarts.
tools.siliconharbour.githubLocationBulkContinue(input: { "runId": string; "downloadAvatars"?: boolean; "confirm": true })
Process the next GitHub location import batch. Fetch profiles and apply the existing import rules, optionally downloading guarded avatars. Respect importer rate limits. Requires confirm: true.
tools.siliconharbour.githubLocationBulkPause(input: { "runId": string })
Pause the bulk GitHub location import. Wait for the active batch to finish, then pause. Existing imported records are retained.
tools.siliconharbour.githubLocationBulkReset(input: { "runId": string; "confirm": true })
Reset bulk GitHub location import progress. Wait for the active batch to finish, then clear progress without deleting imported directory records. Requires confirm: true.
tools.siliconharbour.githubLocationBulkStart(input: { "runId": string | null; "confirm": true })
Start the bulk GitHub location import. Initialize or resume the location import. Completed runs require reset before restarting. Requires confirm: true. Advance it with githubLocationBulkContinue and poll githubLocationBulkStatus.
tools.siliconharbour.githubLocationBulkStatus(input: { })
Get bulk GitHub location import progress. Read stored progress and rate-limit status without advancing the import. Poll after githubLocationBulkStart or Continue.
tools.siliconharbour.githubLocationImport(input: { "users": Array<{ "login": string; "id": number; "avatar_url": string; "html_url": string; "name": string | null; "company": string | null; "bio": string | null; "blog": string | null; "location": string | null; "public_repos": number; "twitter_username": string | null }>; "downloadAvatars"?: boolean })
Import reviewed GitHub location profiles. Skip blocklisted identities. Merge missing GitHub details into unlinked people or create hidden people, synchronize company references, and optionally fetch avatars through the image guard. Return per-profile results.
tools.siliconharbour.githubLocationSearch(input: { "page"?: number; "confirm": true })
Search GitHub for Newfoundland profiles. Run the existing location search terms, fetch full profiles for one page, and return rate-limit metadata without importing people. Requires confirm: true.
tools.siliconharbour.importerTypeList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "name" })
List supported job importers. Return ATS type identifiers with approach, reliability, and operational notes. No live source requests run.
tools.siliconharbour.importSyncAll(input: { "types"?: Array<"event" | "job" | "news">; "confirm": true })
Queue an asynchronous sync across import source types. Queue each selected source once, in event, job, then news order. Event sources use the shared ordering and Luma request queue. Defaults to all types. Returns one process-local run; poll with asyncSyncGet. Same-source overlap fails instead of fetching or applying twice; other sources still run. Requires confirm: true.
jobs (33)
tools.siliconharbour.jobApprove(input: { "id": number })
Approve a job as technical. Set status to active and isTechnical to true. Approve technical roles in St. John's/NL or remote in Canada; use jobApproveNonTechnical for other relevant local/remote roles and jobHide for unrelated postings. Imported fields remain unchanged.
tools.siliconharbour.jobApproveNonTechnical(input: { "id": number })
Approve a nontechnical job. Set status to active and isTechnical to false. Preserve the imported description and source.
tools.siliconharbour.jobBulkApprove(input: { "ids": Array<number> })
Approve selected jobs. Set status to active and isTechnical to true. Approve technical roles in St. John's/NL or remote in Canada; use jobApproveNonTechnical for other relevant local/remote roles and jobHide for unrelated postings. Imported fields remain unchanged. Apply to at most 200 distinct IDs in input order, using the same single-record operation. Return a result for each ID and continue after failures.
tools.siliconharbour.jobBulkHide(input: { "ids": Array<number>; "confirm": true })
Hide selected jobs. Set status to hidden. It remains stored and the importer will not reactivate it. Use jobUnhide to return it to review. Apply to at most 200 distinct IDs in input order, using the same single-record operation. Return a result for each ID and continue after failures. Requires confirm: true.
tools.siliconharbour.jobCreate(input: { "title": string; "description": string; "url": string; "companyId"?: number | null; "companyName"?: string; "location"?: string | null; "department"?: string | null; "workplaceType"?: "remote" | "onsite" | "hybrid" | null; "salaryRange"?: string | null; "isTechnical"?: boolean; "postedAt"?: string | null; "ifNotExists"?: boolean })
Create a manual job. Create an active manual posting, derive its slug, and synchronize references. Resolve optional companyName when companyId is omitted. isTechnical defaults to true. postedAt defaults to the current time; supply an ISO timestamp to backdate a manual posting, or null to leave it unset. Set ifNotExists to return an existing record by canonical application URL. Existing records are unchanged and return created:false; new records return created:true.
tools.siliconharbour.jobDeactivate(input: { "id": number; "reason": "removed" | "filled" | "expired" })
Deactivate a job. Mark a job removed, filled, or expired and record removedAt. Works for manual and imported jobs; field edits remain guarded.
tools.siliconharbour.jobDelete(input: { "id": number; "confirm": true })
Delete a job permanently. Hard-delete a manual or imported job. Use jobHide to preserve it. Requires confirm: true.
tools.siliconharbour.jobGet(input: { "id"?: number; "slug"?: string; "name"?: string })
Get one job. Look up a manual or imported job by ID, slug, or exact title, including hidden records.
tools.siliconharbour.jobHide(input: { "id": number })
Hide a job. Set status to hidden. It remains stored and the importer will not reactivate it. Use jobUnhide to return it to review.
tools.siliconharbour.jobHideAllPending(input: { "confirm": true })
Hide every pending job. Set all pending_review jobs to hidden. Keep records and source ownership. Requires confirm: true.
tools.siliconharbour.jobList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "postedAt" | "title" | "lastSeenAt"; "status"?: "active" | "pending_review" | "removed" | "filled" | "expired" | "hidden" | "all"; "sourceId"?: number | null; "companyId"?: number; "isTechnical"?: boolean; "sourceType"?: "manual" | "imported"; "workplaceType"?: "remote" | "onsite" | "hybrid"; "location"?: string; "lastSeenAfter"?: string })
List jobs for administration. Return a bounded page, including hidden, nontechnical, and imported jobs. Filter by title, status, company, source, or technical classification.
tools.siliconharbour.jobMarkNonTechnical(input: { "id": number })
Mark a job as nontechnical. Set isTechnical to false without changing publication status.
tools.siliconharbour.jobMarkTechnical(input: { "id": number })
Mark a job as technical. Set isTechnical to true without changing publication status. Use jobApprove to also activate it.
tools.siliconharbour.jobPublicGet(input: { "slug": string })
Get one public job by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use jobGet for operational fields.
tools.siliconharbour.jobPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "postedAt" | "title" | "lastSeenAt"; "companyId"?: number; "sourceId"?: number; "status"?: "active"; "isTechnical"?: boolean; "workplaceType"?: "remote" | "onsite" | "hybrid"; "location"?: string; "lastSeenAfter"?: string })
List public jobs. Return a bounded page with optional text search. Only active jobs; no source credentials or private source URLs are returned. Administrators use jobList for moderation data.
tools.siliconharbour.jobRequeue(input: { "id": number })
Requeue a job for review. Reset status to pending_review without deleting its data.
tools.siliconharbour.jobSearchImport(input: { "title": string; "companyName"?: string | null; "location"?: string | null; "url": string; "description"?: string | null; "salary"?: string | null; "isRemote"?: boolean; "ifNotExists"?: boolean })
Import a reviewed search result as a manual job. Match companyName against the directory when supplied. Use title as description when omitted, and save a manual active job with normal slug and reference handling. This makes no network request. Set ifNotExists to return an existing record by canonical application URL. Existing records are unchanged and return created:false; new records return created:true. Directory names are never used as identities.
tools.siliconharbour.jobSearchIndeed(input: { "query"?: string; "location"?: string; "limit"?: number; "hoursOld"?: number; "confirm": true })
Search Indeed for jobs. Fetch live results with company, duplicate, and ATS-source matches. Does not save jobs. Requires confirm: true; use jobSearchImport to save one result.
tools.siliconharbour.jobSearchLinkedIn(input: { "query"?: string; "location"?: string; "limit"?: number; "hoursOld"?: number; "confirm": true })
Search LinkedIn for jobs. Fetch live public job results with company and duplicate matches. Does not import jobs. Requires confirm: true.
tools.siliconharbour.jobSourceCreate(input: { "companyId": number; "sourceType": "greenhouse" | "ashby" | "workday" | "bamboohr" | "lever" | "collage" | "rippling" | "adp" | "careerbeacon" | "workable" | "icims" | "jibe" | "oracle-hcm" | "successfactors" | "dayforce" | "jazzhr" | "custom" | "kyrix"; "sourceIdentifier": string; "sourceUrl"?: string | null; "skipValidation"?: boolean; "confirm": true; "ifNotExists"?: boolean })
Validate and create a job import source. Validate ATS configuration using a live fetch unless skipValidation is true. The company must exist. No sync runs after creation. Requires confirm: true. Set ifNotExists to return an existing record by company ID, source type and provider identifier. Existing records are unchanged and return created:false; new records return created:true.
tools.siliconharbour.jobSourceDelete(input: { "id": number; "confirm": true })
Delete a job source. Remove the source and cascade its imported jobs using the existing service. Requires confirm: true.
tools.siliconharbour.jobSourceGet(input: { "id": number })
Get an import source and its review records. Return source configuration, lifecycle groups and review data for administrators. Throws when the source does not exist. Use the entity list for filtered pages.
tools.siliconharbour.jobSourceList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "name" })
List job import sources and lifecycle counts. Return ATS configuration and active, pending, hidden, removed, filled, expired, and total job counts.
tools.siliconharbour.jobSourceManualSync(input: { "id": number; "jobs": Array<{ "externalId": string; "title": string; "url": string; "location"?: string; "department"?: string; "descriptionHtml"?: string; "descriptionText"?: string; "salaryRange"?: string; "workplaceType"?: "remote" | "onsite" | "hybrid"; "postedAt"?: string; "updatedAt"?: string }> })
Ingest captured Verafin job JSON. Accept typed jobs captured in the browser. Only the configured Verafin manual source supports this flow. Reconcile jobs using the same importer lifecycle rules without a network fetch.
tools.siliconharbour.jobSourceSync(input: { "id": number; "confirm": true; "async"?: boolean })
Sync one ATS job source. Fetch live jobs and apply importer lifecycle rules. Requires confirm: true. Set async to return a run ID immediately; poll asyncSyncGet.
tools.siliconharbour.jobSourceSyncAll(input: { "confirm": true; "async"?: boolean })
Sync every ATS job source. Fetch sources sequentially and return aggregate lifecycle counts and per-source results. Requires confirm: true. Set async to poll the run with asyncSyncGet.
tools.siliconharbour.jobSourceTechPreviewApply(input: { "id": number; "technologyIds": Array<number>; "sourceKey"?: "job_postings" | "get_coding_reference"; "sourceUrl"?: string | null; "lastVerified"?: string | null })
Apply selected job technology evidence to a company. Use technology IDs from this source's preview, assign them to its company, and attach job evidence. The provenance sourceKey supplies source defaults. Verification defaults to the current month. Existing unrelated assignments remain.
tools.siliconharbour.jobSourceTechPreviewExtract(input: { "id": number })
Extract technology mentions for a job source. Replace extracted mentions for the source's eligible jobs and return a preview of matching technologies. This writes mention rows but does not apply company technology assignments.
tools.siliconharbour.jobSourceUpdate(input: { "id": number; "sourceType"?: "greenhouse" | "ashby" | "workday" | "bamboohr" | "lever" | "collage" | "rippling" | "adp" | "careerbeacon" | "workable" | "icims" | "jibe" | "oracle-hcm" | "successfactors" | "dayforce" | "jazzhr" | "custom" | "kyrix"; "sourceIdentifier"?: string; "sourceUrl"?: string | null })
Update job source configuration. Patch ATS type, identifier, or URL without running a sync. Company ownership stays fixed.
tools.siliconharbour.jobTechNLGet(input: { "link": string })
Get one live TechNL job. Find an exact posting link in the fixed TechNL feed. The supplied link is only a lookup key; it is never fetched.
tools.siliconharbour.jobTechNLList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "postedAt" | "title" })
Read the live TechNL job board. Fetch the fixed TechNL feed and enrich postings with directory and existing-job matches. This read does not save jobs.
tools.siliconharbour.jobUnhide(input: { "id": number })
Return a hidden job to review. Set status to pending_review while preserving its technical classification.
tools.siliconharbour.jobUpdate(input: { "id": number; "title"?: string; "description"?: string; "url"?: string; "companyId"?: number | null; "location"?: string | null; "department"?: string | null; "workplaceType"?: "remote" | "onsite" | "hybrid" | null; "salaryRange"?: string | null; "isTechnical"?: boolean; "postedAt"?: string | null })
Update a manual job. Patch supplied fields, including an optional ISO postedAt (null clears it), regenerate the slug on title changes, and synchronize references. Imported jobs reject field edits because the next sync overwrites them; jobHide, jobMarkTechnical, jobMarkNonTechnical, jobApprove, and jobDeactivate still work.
news (24)
tools.siliconharbour.newsApprove(input: { "id": number })
Approve and publish a news item. Set status to published and set publishedAt from the operation clock only when absent. Preserve an existing publish date.
tools.siliconharbour.newsArticleCreate(input: { "title": string; "content": string; "excerpt"?: string | null; "status"?: "draft" | "pending_review" | "published" | "hidden"; "externalUrl"?: string | null; "sourceName"?: string | null; "sourceEntityUrl"?: string | null; "publishedAt"?: string | null; "coverImage"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "type"?: "link" | "article"; "ifNotExists"?: boolean })
Create a news article or a manually entered link. Save supplied content without fetching its URL. Defaults to a draft article. Published records receive publishedAt from the operation clock unless explicitly supplied. Use newsLinkSubmit to fetch link metadata. Synchronize references and prepare cover images before writing. Set ifNotExists to return an existing record by canonical external URL, or exact article type, title and content. Existing records are unchanged and return created:false; new records return created:true.
tools.siliconharbour.newsBulkApprove(input: { "ids": Array<number> })
Approve selected news. Set status to published and set publishedAt from the operation clock only when absent. Preserve an existing publish date. Apply to at most 200 distinct IDs in input order, using the same single-record operation. Return a result for each ID and continue after failures.
tools.siliconharbour.newsBulkHide(input: { "ids": Array<number>; "confirm": true })
Hide selected news. Set status to hidden and preserve publishedAt. The record remains editable. Apply to at most 200 distinct IDs in input order, using the same single-record operation. Return a result for each ID and continue after failures. Requires confirm: true.
tools.siliconharbour.newsDelete(input: { "id": number; "confirm": true })
Delete a news article or link. Remove the record and clean up unreferenced cover images. Requires confirm: true.
tools.siliconharbour.newsGet(input: { "id"?: number; "slug"?: string; "name"?: string })
Get a news article or link. Look up a stored news record, including draft content, by ID, slug, or exact title.
tools.siliconharbour.newsGlobalKeywordsGet(input: { })
Get global news import keywords. Return the keyword array used by news sources that enable global filtering.
tools.siliconharbour.newsGlobalKeywordsSet(input: { "keywords": Array<string> | null })
Set global news import keywords. Replace the keyword array; null or an empty array clears it. Source-specific keywords remain unchanged.
tools.siliconharbour.newsHide(input: { "id": number })
Hide a news item. Set status to hidden and preserve publishedAt. The record remains editable.
tools.siliconharbour.newsHideAllPending(input: { "confirm": true })
Hide every pending news item. Set pending_review items to hidden without deleting them. Requires confirm: true.
tools.siliconharbour.newsLinkSubmit(input: { "url": string; "title"?: string; "excerpt"?: string | null; "sourceName"?: string | null; "confirm": true; "ifNotExists"?: boolean })
Fetch and publish a news link. Fetch HTML through the public-address guard, extract title and description, and publish immediately with publishedAt from the operation clock. Optional title, excerpt, and sourceName override metadata. Requires confirm: true. Set ifNotExists to return an existing record by canonical submitted URL. Existing records are unchanged and return created:false; new records return created:true.
tools.siliconharbour.newsList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "title" | "publishedAt"; "status"?: "draft" | "pending_review" | "published" | "hidden"; "sourceId"?: number | null; "type"?: "link" | "article" })
List news including drafts. Return a bounded page filtered by title, status, source, or article/link type.
tools.siliconharbour.newsPublicGet(input: { "slug": string })
Get one public news by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use newsGet for operational fields.
tools.siliconharbour.newsPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "title" | "publishedAt" })
List public news. Return a bounded page with optional text search. Only published news is returned. Administrators use newsList for moderation data.
tools.siliconharbour.newsSourceCreate(input: { "name": string; "sourceType": "rss" | "custom"; "sourceUrl": string; "sourceIdentifier"?: string | null; "keywords"?: Array<string> | null; "useGlobalKeywords"?: boolean; "useCompanyNameFilter"?: boolean; "excerptMode"?: "description" | "content" | "none"; "entityUrl"?: string | null; "enabled"?: boolean; "ifNotExists"?: boolean })
Create a news import source. Store source and keyword configuration without fetching it. Use newsSourceTestFeed for an SSRF-guarded preview and newsSourceSync to import. Set ifNotExists to return an existing record by source type and canonical feed URL. Existing records are unchanged and return created:false; new records return created:true.
tools.siliconharbour.newsSourceDelete(input: { "id": number; "confirm": true })
Delete a news source and its imported items. Delete associated news records and unreferenced cover images before removing the source. Requires confirm: true.
tools.siliconharbour.newsSourceGet(input: { "id": number })
Get an import source and its review records. Return source configuration, lifecycle groups and review data for administrators. Throws when the source does not exist. Use the entity list for filtered pages.
tools.siliconharbour.newsSourceList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "name" })
List news import sources. Return RSS/custom source URLs, filtering options, enabled state, and last-sync results.
tools.siliconharbour.newsSourceSync(input: { "id": number; "confirm": true; "async"?: boolean })
Sync one news source. Fetch and import news using source filters and the existing importer. Requires confirm: true. Set async to poll a background run with asyncSyncGet.
tools.siliconharbour.newsSourceSyncAll(input: { "confirm": true; "async"?: boolean })
Sync every enabled news source. Skip disabled sources and return aggregate import counts. Requires confirm: true. Set async to return a run ID and poll asyncSyncGet.
tools.siliconharbour.newsSourceTestFeed(input: { "id"?: number; "sourceUrl"?: string; "keywords"?: Array<string> | null; "excerptMode"?: "description" | "content" | "none"; "confirm": true })
Preview a news RSS or Atom feed. Supply a stored source id or a sourceUrl. Fetch through the public-address guard and return parsed items with keyword matches without saving them. Explicit preview options override stored values. Requires confirm: true.
tools.siliconharbour.newsSourceUpdate(input: { "id": number; "name"?: string; "sourceType"?: "rss" | "custom"; "sourceUrl"?: string; "sourceIdentifier"?: string | null; "keywords"?: Array<string> | null; "useGlobalKeywords"?: boolean; "useCompanyNameFilter"?: boolean; "excerptMode"?: "description" | "content" | "none"; "entityUrl"?: string | null; "enabled"?: boolean })
Update a news import source. Patch supplied configuration fields, including enabled state and keyword filters. No fetch runs.
tools.siliconharbour.newsUnhide(input: { "id": number })
Return hidden news to review. Set status to pending_review. This does not publish the item or reset its publish date.
tools.siliconharbour.newsUpdate(input: { "id": number; "title"?: string; "content"?: string; "excerpt"?: string | null; "status"?: "draft" | "pending_review" | "published" | "hidden"; "externalUrl"?: string | null; "sourceName"?: string | null; "sourceEntityUrl"?: string | null; "publishedAt"?: string | null; "coverImage"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true } })
Update a news article or link. Patch supplied fields; unknown keys and empty patches fail. Publishing sets publishedAt when absent; hiding preserves it. Explicit publishedAt wins, including null. Article content must remain nonempty. Renaming updates the slug; content updates synchronize references. Replaced covers are removed when unreferenced.
newsletter (15)
tools.siliconharbour.newsletterCampaignCreate(input: { "subject": string; "bodyMarkdown": string; "ifNotExists"?: boolean })
Create a newsletter draft. Create a campaign for the configured list using the site's sender defaults. Does not send email. Set ifNotExists to return an existing record by exact subject and Markdown body within the configured list. Existing records are unchanged and return created:false; new records return created:true.
tools.siliconharbour.newsletterCampaignGet(input: { "id": number; "offset"?: number })
Get a campaign, preview, and delivery history. Verify list ownership and return the campaign, rendered preview, rollout flags, confirmed pilot count, and 50 send records starting at offset.
tools.siliconharbour.newsletterCampaignList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "desc"; "sort"?: "createdAt" })
List newsletter campaigns. Read campaigns belonging to the configured Silicon Harbour list through the lists API, newest first. total is null because the provider has no count. Offsets track provider rows; a filtered page may be empty with a non-null nextOffset. Subscriber and campaign data remain administrator-only.
tools.siliconharbour.newsletterCampaignSave(input: { "subject": string; "bodyMarkdown": string; "id": number })
Save a newsletter draft. Require a draft owned by the configured list. Replace subject and Markdown body without sending it.
tools.siliconharbour.newsletterCampaignSendLive(input: { "id": number; "confirm": true; "confirmationSubject": string })
Send a newsletter to the confirmed list. Verify campaign ownership and require the liveSend rollout flag. This sends real email to the full confirmed audience. Requires the exact confirmationSubject and confirm: true.
tools.siliconharbour.newsletterCampaignSendTest(input: { "id": number; "confirm": true })
Send a newsletter to confirmed pilot subscribers. Verify list ownership and send the campaign to configured, confirmed pilot addresses only. Requires confirm: true. Full-list liveSend need not be enabled.
tools.siliconharbour.newsletterListGet(input: { })
Get the configured mailing list. Return the list identity and sender address. No credentials are returned; missing configuration fails.
tools.siliconharbour.newsletterOverviewGet(input: { })
Get newsletter configuration and subscriber counts. Return rollout flags and provider counts when configured. Provider errors remain visible; an unconfigured service makes no outbound request.
tools.siliconharbour.newsletterPilotSubscribe(input: { "confirm": true })
Request confirmation from configured pilot addresses. Skip confirmed or blocklisted pilot addresses, and send confirmations to the remaining configured pilots. Requires confirm: true.
tools.siliconharbour.newsletterSettingsGet(input: { })
Get newsletter rollout flags. Return publicSignup and liveSend. Configuration credentials are never returned.
tools.siliconharbour.newsletterSettingsSet(input: { "publicSignup": boolean; "liveSend": boolean })
Change newsletter signup and live-send flags. Replace both rollout flags. Production public signup requires configured Turnstile keys. Enabling liveSend permits later full-list sends, but this operation sends no email.
tools.siliconharbour.newsletterSubscriberCreate(input: { "email": string; "firstName"?: string | null; "lastName"?: string | null; "confirm": true; "ifNotExists"?: boolean })
Add or resubscribe a newsletter member. Respect the production signup rollout: when disabled, only configured pilot addresses may be added. Send a subscription confirmation email. Requires confirm: true. Set ifNotExists to return an existing record by email within the configured list; an existing member is not resubscribed or sent another confirmation. Existing records are unchanged and return created:false; new records return created:true.
tools.siliconharbour.newsletterSubscriberList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "desc"; "sort"?: "createdAt" })
List newsletter subscribers. Search the configured list with limit/offset, newest first. total is null because the provider has no count; follow nextOffset until null. Email addresses and membership status are administrator-only.
tools.siliconharbour.newsletterSubscriberResendConfirmation(input: { "email": string; "confirm": true })
Resend a subscription confirmation. Require an active, unconfirmed member of the configured list and respect the production signup rollout. Requires confirm: true.
tools.siliconharbour.newsletterSubscriberUnsubscribe(input: { "id": number; "confirm": true })
Unsubscribe a list member. Remove the member from the configured list using the lists API. Requires confirm: true.
operations (1)
tools.siliconharbour.operationDescribe(input: { "name": string })
Describe an available operation and its contracts. Return input/output JSON Schemas, access, risk and examples for an operation available to this actor and scopes. No records are read. Use this inside a program after discovering a name.
people (12)
tools.siliconharbour.personApprove(input: { "id": number })
Approve a person for public display. Set visible to true. Use personUnapprove to hide the record without deleting it.
tools.siliconharbour.personBulkReject(input: { "pattern": string; "reason"?: string | null; "confirm": true })
Reject hidden people matching every search term. Split pattern on spaces or commas and match every term against name, biography, and social links. Only hidden people are affected. Block each stored GitHub identity and retain each rejection for seven days. Optional reason describes new blocks; existing block metadata is preserved. Use rejectedRecordList to find restore IDs. Requires confirm: true.
tools.siliconharbour.personCreate(input: { "name": string; "bio"?: string | null; "website"?: string | null; "externalLinks"?: { "github"?: string | null; "wikipedia"?: string | null; "twitter"?: string | null; "linkedin"?: string | null; "instagram"?: string | null; "youtube"?: string | null; "mastodon"?: string | null; "bluesky"?: string | null; "facebook"?: string | null } | null; "avatar"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "visible"?: boolean; "ifNotExists"?: boolean })
Create a person. Create the record through the shared service, derive its slug, and synchronize references. Optional images support upload, public URL, data URL, keep, or clear. New records default to hidden until approved. Set ifNotExists to return an existing record by GitHub profile, or website when no GitHub profile is supplied. Existing records are unchanged and return created:false; new records return created:true.
tools.siliconharbour.personDelete(input: { "id": number; "confirm": true; "block"?: { "source": "github"; "reason"?: string | null } })
Delete a person, optionally blocking future imports. Read the stored GitHub profile when block is provided, normalize its import key, block before deletion, and remove unreferenced images. Optional block.reason explains a new block; existing block metadata is preserved. Requires confirm: true. Returns the removed record.
tools.siliconharbour.personGet(input: { "id"?: number; "slug"?: string; "name"?: string })
Get one person. Return the stored record including hidden fields for administration. Throws when the record does not exist.
tools.siliconharbour.personHideAllVisible(input: { "confirm": true })
Hide all visible people. Set visible to false without deleting records or images. Requires confirm: true.
tools.siliconharbour.personList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "name" | "createdAt" | "updatedAt"; "visible"?: boolean })
List people for administration. Return a bounded page including hidden records. Filter by query or visibility. Use personGet for one record.
tools.siliconharbour.personPublicGet(input: { "slug": string })
Get one public person by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use personGet for operational fields.
tools.siliconharbour.personPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "name" })
List public people. Return a bounded page with optional text search. Hidden records are excluded. Administrators use personList for moderation data.
tools.siliconharbour.personReject(input: { "id": number; "confirm": true; "reason"?: string | null })
Reject a person from the review queue. Block the stored import identity when present and retain the record for seven days, hidden from the directory and review queues. Preserve images, ID, slug and relationships. Optional reason describes a new block; existing block metadata is preserved. Use rejectedRecordRestore with restoreId to undo, or rejectedRecordDelete to permanently remove it. Requires confirm: true.
tools.siliconharbour.personUnapprove(input: { "id": number })
Hide an approved person. Set visible to false while preserving the record and its images.
tools.siliconharbour.personUpdate(input: { "id": number; "name"?: string; "bio"?: string | null; "website"?: string | null; "externalLinks"?: { "github"?: string | null; "wikipedia"?: string | null; "twitter"?: string | null; "linkedin"?: string | null; "instagram"?: string | null; "youtube"?: string | null; "mastodon"?: string | null; "bluesky"?: string | null; "facebook"?: string | null } | null; "avatar"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "visible"?: boolean })
Update a person. Patch only supplied fields; empty patches and unknown keys fail. externalLinks merges supplied keys; a null key removes that link, and a null object clears all links. Renaming regenerates the slug and text changes synchronize references. Replaced or cleared images are removed only when unreferenced.
products (7)
tools.siliconharbour.productCreate(input: { "name": string; "description": string; "type"?: "saas" | "mobile" | "physical" | "service" | "other"; "website"?: string | null; "companyId"?: number | null; "logo"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "coverImage"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "ifNotExists"?: boolean })
Create a product. Create the record through the shared service, derive its slug, and synchronize references. Optional images support upload, public URL, data URL, keep, or clear. Set ifNotExists to return an existing record by canonical website. Existing records are unchanged and return created:false; new records return created:true.
tools.siliconharbour.productDelete(input: { "id": number; "confirm": true })
Delete a product. Delete the record and clean up unreferenced images. Requires confirm: true. Returns the deleted record for review history.
tools.siliconharbour.productGet(input: { "id"?: number; "slug"?: string; "name"?: string })
Get one product. Return the stored record including hidden fields for administration. Throws when the record does not exist.
tools.siliconharbour.productList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "name" | "createdAt" | "updatedAt" })
List products for administration. Return a bounded page including hidden records. Filter by query or visibility. Use productGet for one record.
tools.siliconharbour.productPublicGet(input: { "slug": string })
Get one public product by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use productGet for operational fields.
tools.siliconharbour.productPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "name" })
List public products. Return a bounded page with optional text search. Follow the public directory visibility rules. Administrators use productList for moderation data.
tools.siliconharbour.productUpdate(input: { "id": number; "name"?: string; "description"?: string; "type"?: "saas" | "mobile" | "physical" | "service" | "other"; "website"?: string | null; "companyId"?: number | null; "logo"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "coverImage"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true } })
Update a product. Patch only supplied fields; empty patches and unknown keys fail. Renaming regenerates the slug and text changes synchronize references. Replaced or cleared images are removed only when unreferenced.
projects (11)
tools.siliconharbour.projectCreate(input: { "name": string; "description": string; "type"?: "game" | "webapp" | "library" | "tool" | "hardware" | "other"; "status"?: "active" | "completed" | "archived" | "on-hold"; "links"?: { "github"?: string | null; "itchio"?: string | null; "website"?: string | null; "demo"?: string | null; "npm"?: string | null; "pypi"?: string | null; "steam"?: string | null; "appstore"?: string | null; "playstore"?: string | null } | null; "logo"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "coverImage"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "technologyIds"?: Array<number>; "ifNotExists"?: boolean })
Create a project. Create the record through the shared service, derive its slug, and synchronize references. Optional images support upload, public URL, data URL, keep, or clear. Set ifNotExists to return an existing record by GitHub repository URL, or project website. Existing records are unchanged and return created:false; new records return created:true.
tools.siliconharbour.projectDelete(input: { "id": number; "confirm": true })
Delete a project. Delete the record and clean up unreferenced images. Requires confirm: true. Returns the deleted record for review history.
tools.siliconharbour.projectGalleryAdd(input: { "id": number; "image": { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string }; "caption"?: string | null })
Add a project gallery image. Accept a public image URL, a prepared upload, or a cropped data URL, normalize it to WebP, and append it with an optional caption. Use projectGalleryRemove to delete it.
tools.siliconharbour.projectGalleryRemove(input: { "id": number; "imageId": number; "confirm": true })
Remove a project gallery image. Remove only an image belonging to this project and delete the file when unreferenced. Requires confirm: true.
tools.siliconharbour.projectGalleryReorder(input: { "id": number; "imageIds": Array<number> })
Reorder a project gallery. Supply every image ID belonging to the project exactly once in the desired order. Reject missing, duplicate or foreign IDs before writing. Persist consecutive positions in one transaction; images and captions stay unchanged. Empty galleries accept an empty array.
tools.siliconharbour.projectGalleryUpdate(input: { "id": number; "imageId": number; "caption": string | null })
Edit a project gallery caption. Update a caption without replacing the image or changing its position. Null or blank clears the caption. The image must belong to the supplied project; otherwise throws NotFound.
tools.siliconharbour.projectGet(input: { "id"?: number; "slug"?: string; "name"?: string })
Get one project. Return the stored record including hidden fields for administration. Throws when the record does not exist.
tools.siliconharbour.projectList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "name" | "createdAt" | "updatedAt" })
List projects for administration. Return a bounded page including hidden records. Filter by query or visibility. Use projectGet for one record.
tools.siliconharbour.projectPublicGet(input: { "slug": string })
Get one public project by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use projectGet for operational fields.
tools.siliconharbour.projectPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "name" })
List public projects. Return a bounded page with optional text search. Follow the public directory visibility rules. Administrators use projectList for moderation data.
tools.siliconharbour.projectUpdate(input: { "id": number; "name"?: string; "description"?: string; "type"?: "game" | "webapp" | "library" | "tool" | "hardware" | "other"; "status"?: "active" | "completed" | "archived" | "on-hold"; "links"?: { "github"?: string | null; "itchio"?: string | null; "website"?: string | null; "demo"?: string | null; "npm"?: string | null; "pypi"?: string | null; "steam"?: string | null; "appstore"?: string | null; "playstore"?: string | null } | null; "logo"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "coverImage"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "technologyIds"?: Array<number> })
Update a project. Patch only supplied fields; empty patches and unknown keys fail. links merges supplied keys; a null key removes that link, and a null object clears all links. Renaming regenerates the slug and text changes synchronize references. Replaced or cleared images are removed only when unreferenced.
technologies (7)
tools.siliconharbour.technologyCreate(input: { "name": string; "category": "language" | "frontend" | "backend" | "cloud" | "database" | "games-and-graphics" | "mobile" | "data-science" | "llm" | "platform" | "specialized"; "description"?: string | null; "website"?: string | null; "icon"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "visible"?: boolean; "ifNotExists"?: boolean })
Create a technology. Create the record through the shared service, derive its slug, and synchronize references. Optional images support upload, public URL, data URL, keep, or clear. New records default to hidden until approved. Set ifNotExists to return an existing record by the catalog slug derived from the technology name. Existing records are unchanged and return created:false; new records return created:true.
tools.siliconharbour.technologyDelete(input: { "id": number; "confirm": true })
Delete a technology. Delete the record and clean up unreferenced images. Requires confirm: true. Returns the deleted record for review history.
tools.siliconharbour.technologyGet(input: { "id"?: number; "slug"?: string; "name"?: string })
Get one technology. Return the stored record including hidden fields for administration. Throws when the record does not exist.
tools.siliconharbour.technologyList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "name" | "createdAt" | "updatedAt"; "visible"?: boolean })
List technologies for administration. Return a bounded page including hidden records. Filter by query or visibility. Use technologyGet for one record.
tools.siliconharbour.technologyPublicGet(input: { "slug": string })
Get one public technology by slug. Return public fields and visible related records. Hidden or missing records return NotFound; source identifiers, moderation data and import configuration are excluded. Administrators use technologyGet for operational fields.
tools.siliconharbour.technologyPublicList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "name" })
List public technologies. Return a bounded page with optional text search. Hidden records are excluded. Administrators use technologyList for moderation data.
tools.siliconharbour.technologyUpdate(input: { "id": number; "name"?: string; "category"?: "language" | "frontend" | "backend" | "cloud" | "database" | "games-and-graphics" | "mobile" | "data-science" | "llm" | "platform" | "specialized"; "description"?: string | null; "website"?: string | null; "icon"?: { "kind": "keep" } | { "kind": "clear"; "confirm": true } | { "kind": "url"; "confirm": true; "url": string } | { "kind": "upload"; "confirm": true; "uploadId": string } | { "kind": "dataUrl"; "confirm": true; "dataUrl": string } | { "kind": "generateFromIcon"; "confirm": true }; "visible"?: boolean })
Update a technology. Patch only supplied fields; empty patches and unknown keys fail. Renaming regenerates the slug and text changes synchronize references. Replaced or cleared images are removed only when unreferenced.
theme shares (2)
tools.siliconharbour.themeShareDelete(input: { "id": string; "confirm": true })
Delete one saved theme share. Remove the saved theme and its logo. Does not remove local browser copies. Requires confirm: true.
tools.siliconharbour.themeShareList(input: { "limit"?: number; "offset"?: number; "query"?: string; "order"?: "asc" | "desc"; "sort"?: "createdAt" | "updatedAt" | "name" })
List saved theme shares. Return paginated shares with IPs and timestamps for administration. Never returns editing keys or logo bytes. Use themeShareDelete to remove one.

Connect an MCP client

Add the endpoint to any client that supports remote MCP servers:

{
  "mcpServers": {
    "siliconharbour": {
      "url": "https://siliconharbour.dev/mcp"
    }
  }
}

You can use search and query without signing in. These tools provide read-only access to public SiliconHarbour data.

OAuth is optional. To use the execute tool, start your MCP client's sign-in action and log in with your SiliconHarbour account. The client discovers the OAuth endpoints automatically and opens the site's login and consent flow. You do not need an API key or shared secret.

The execute tool requires the mcp:write OAuth scope and an administrator account. It can run imports, create or update records, and perform review actions. An invalid or expired OAuth session is rejected instead of falling back to public access.

Programs run in Code Mode, a restricted JavaScript interpreter. Call functions through tools.siliconharbour with one input object ({} when no parameters are needed), then return the result. Imports and module exports are unavailable. Use await for every started call, and Promise.all for independent calls.

Inside a program, search({ query: "company" }) discovers tool signatures. The separate MCP search tool also provides entity field details.

Responses contain ok, value or error, toolCalls, and optional logs, warnings, and truncated. Queries have a 10-second timeout; authenticated actions have 60 seconds. Both allow at most 100 tool calls and retain up to 64 KiB of result and logs. Narrow results or paginate when output is truncated. A failed execution can have completed earlier writes; inspect toolCalls before retrying. Timeouts do not undo writes or cancel existing database/import operations.

Example queries

// Upcoming events
return await tools.siliconharbour.eventPublicList({ upcoming: true, limit: 5 });
// Jobs filtered by keyword
return await tools.siliconharbour.jobPublicList({ query: "developer", limit: 10 });
// Cross-entity query
const [upcoming, cos, grps] = await Promise.all([
  tools.siliconharbour.eventPublicList({ upcoming: true }),
  tools.siliconharbour.companyPublicList({ limit: 5 }),
  tools.siliconharbour.groupPublicList({ limit: 5 }),
]);
return {
  upcoming: upcoming.items.length,
  companies: cos.items.map((c) => c.name),
  groups: grps.items.map((g) => g.name),
};

Feeds

RSS feeds and an iCal calendar are also available. See Stay Connected for details.

  • /feed.rss - Combined RSS feed
  • /events.rss - Events RSS feed
  • /news.rss - News RSS feed
  • /jobs.rss - Jobs RSS feed
  • /calendar.ics - iCal calendar subscription