The public reference for governed resources, analysis, portfolio intelligence, and human-controlled proposals across the Event Operating Layer.
Answer
Governed Ledger → btyCoreReadService → MCP → ei and external agents. Every surface shares the same public capability catalog while live reads remain authenticated and scoped.
MCP endpoint
https://api.buildtheyear.com/mcpLive capabilities
https://api.buildtheyear.com/api/v1/mcp/capabilitiesThe event-leader outcome the capability advances.
Deterministic, heuristic, associative, scenario, or resource.
Read-only, or preview/propose with human approval and commit.
The policy, confidence, and provenance context that travels with an answer.
Whether the capability stays inside the active Chapter or is org-global.
The minimum existing Build the Year role that may use the capability.
The explicit boundary an agent must not cross.
Search and filter 46 public capability contracts. Every card remains in the page markup for crawlers and no-JavaScript readers.
Governed ledger context and reference objects that agents can read.
bty://healthServer health check — returns server status and org context
bty://contextFull org context as markdown — attribution policy, portfolio performance, capacity, data confidence, recommendations, connected systems, and capability routing guide
bty://org/overviewOrganization overview — KPIs, attribution policy, data confidence, capacity, connected systems
bty://eventsPaginated list of all events with key metrics and aggregate totals
bty://events/{eventId}Full event detail — ledger, True ROI, provenance trail
bty://events/{eventId}/costsEvent cost breakdown — budget, actuals, variance, capacity hours
bty://events/{eventId}/outcomesEvent outcomes — pipeline influenced, revenue attributed, opportunities
bty://events/{eventId}/kpisEvent KPIs — True ROI, cost-per-lead, yield, confidence breakdown
bty://events/{eventId}/provenanceEvent provenance — field-level source records for every tracked value
bty://events/{eventId}/changelogEvent changelog — timestamped changes from provenance and activity logs
bty://portfolio/yieldPortfolio yield — pipeline per capacity hour, tier breakdown, period comparison
bty://portfolio/roiPortfolio ROI — overall True ROI, top/bottom events, tier breakdown
bty://portfolio/recommendationsPortfolio recommendations — actionable decisions with diagnosis, impact, and audit links
bty://portfolio/capacityPortfolio capacity — total hours, utilization percentage, resource count (current year)
bty://portfolio/capacity/{year}Portfolio capacity for a specific year — total hours, utilization percentage, resource count
bty://policies/attributionAttribution policy — metric, window, touch model governing pipeline numbers
bty://custom-fields/definitionsOrg-defined custom field schemas — keys, types, labels, allowed values, confidence defaults
bty://custom-fields/events/{eventId}Custom field values for a specific event — with confidence level and provenance per field
bty://reports/capacity/{year}Resource capacity report — per-resource monthly utilization, overtime risk flags, and projected OT cost
bty://reports/budget/{year}Budget report — planned vs. actual spend by month with variance
bty://reports/events/{year}Event report — per-event planned/committed hours, budget vs. actual, and variance
bty://reports/resources/{year}Resource report — per-resource annual hours, utilization, event count, and estimated labor cost
bty://resources/{resourceId}/assignmentsResource assignments — all event assignments for a specific resource with role and event details
bty://chapterActive chapter context — identity, scope, and organization relationship for the current MCP session
bty://integrations/chapter-statusPer-provider integration health and per-chapter CRM campaign mapping coverage — chapter-scoped unmapped count drives ei insight thresholds
bty://governance/proposalsChapter-scoped Decision History with cursor pagination metadata
bty://governance/proposals/{proposalId}One Chapter-scoped Decision History entry with approval and commit evidence
Governed calculations, comparisons, explanations, and executive outputs.
calculate_true_roiCalculate fully-loaded True ROI for a single event or the entire portfolio. Returns ROI value, cost breakdown, pipeline attribution, and confidence scoring.
get_recommendationsGet named, actionable recommendations for the event portfolio — filtered by type and surface. Each includes diagnosis, recommended action, expected impact, and audit links.
generate_cfo_reportGenerate a board-ready executive narrative with portfolio summary, top/bottom performers, budget variance, and decision recommendations.
explain_varianceExplain why a metric (budget, pipeline, attendance, ROI) differed from expectation. Returns named causes from the provenance trail with magnitude and direction.
list_governed_proposalsList Chapter-scoped Decision History. Filter by status or action type and pass next_cursor back as cursor to continue paging.
Portfolio, mix, and capacity intelligence for evaluating the year.
compare_eventsSide-by-side comparison of 2-10 events across dimensions: ROI, cost, pipeline, yield, capacity, attendance. Identifies best/worst performer per dimension.
find_similar_eventsFind events with a similar profile to a given event, scored by tier, format, region, and budget range.
analyze_portfolio_yieldPortfolio yield analysis — pipeline per capacity hour, broken down by tier/format/region with period-over-period comparison and mix health assessment.
identify_anomaliesFlag events with unusual cost, pipeline, attendance, or ROI patterns. Uses statistical analysis with tier normalization and MAD fallback for skewed distributions.
calculate_outsourcing_caseIn-house vs agency cost analysis — break-even, capacity impact, and per-tier recommendation. Scenario-based; review assumptions before acting.
Scenario only: this capability does not mutate committed capacity.
generate_headcount_caseBuild a data-driven business case for additional headcount — FTE gap, cost of not hiring, pipeline at risk, and executive narrative. Scenario-based; review assumptions before acting.
Scenario only: this capability does not mutate committed capacity.
analyze_resource_capacityAnalyze resource capacity utilization and overtime risk. Returns per-resource utilization %, overtime risk flags, and projected OT cost. Supports single resource or portfolio-wide analysis.
identify_portfolio_patternsAnalyze what drives high or low performance across the event portfolio. Splits events into quartiles by the target metric, compares tier/format/budget/capacity dimensions, and identifies statistically significant differences. Uses associative language (correlation, not causation).
compare_periodsPeriod-over-period comparison with named deltas explaining what changed. Compares pipeline, cost, yield, event mix, and capacity across two periods. Identifies top drivers of each change and flags concerning trends.
optimize_tier_mixGiven capacity constraints, recommend the tier allocation that maximizes portfolio yield. Uses greedy optimization based on historical yield per hour by tier. Every recommendation includes reasoning citing historical evidence. This is an indicative recommendation based on historical averages.
portfolio_health_checkComprehensive portfolio health assessment across 6 categories: yield efficiency, cost control, data quality, capacity health, follow-through, and mix balance. Returns an overall score (0-100), red flags, green lights, and specific action items.
Preview and proposal tools. A human must approve and commit every change.
sync_templatesPreview or propose a governed sync of updated tier role templates to existing events. Use action "preview" to see how many events would be affected, then "propose" to create an approval record. This tool cannot commit changes.
MCP cannot approve or commit this proposal.
propose_wrap_up_completionPreview wrap-up completion eligibility or create a governed proposal. This tool cannot approve, reject, commit, or directly update the event.
MCP cannot approve or commit this proposal.
propose_capacity_decisionPreview or propose a record-only governed capacity decision. This tool cannot approve, reject, commit, alter allocations, apply scenarios, or change committed capacity.
MCP cannot approve or commit this proposal.
In Build the Year, go to Settings → Data Sources → Event Intelligence and create an MCP API key. Configure the client endpoint as https://api.buildtheyear.com/mcp. Keep the key in the client’s secret store; never paste it into public configuration or content.
{
"mcpServers": {
"bty-event-intelligence": {
"url": "https://api.buildtheyear.com/mcp"
}
}
}