Machine-readable ✓ llms.txt ✓ agents.json ✓ MCP endpoint OpenAPI spec

Frequently Asked Questions

The business questions worth asking span multiple objects, multiple time periods, and multiple teams. Here's how AI Context Bridge handles that — and why it's built the way it is.

Is it HubSpot Breeze Data Agent repacked?

HubSpot Breeze Data Agent is a genuinely excellent in-app AI tool. It reads live CRM data, updates records, enriches contacts, and answers pipeline questions — all without leaving HubSpot. It's the right tool for real-time CRM operations. If you need to update a deal stage, send a sequence, or pull a quick contact summary, Breeze is exactly the right place to do it.

The structural ceiling appears when the question spans more than one object. HubSpot's own documentation states: "Reports cannot be created using multiple objects." The Breeze AI report builder is a frontend to the same single-object engine — it even labels results "Generated from SQL," which confirms the right idea. The constraint is what SQL it can generate. Questions like pipeline weighted by each rep's real historical close rate, or email click-rate computed across joined engagement and contact tables, require a join before aggregation — something a single-object engine cannot express.

Ask Breeze: "What is each rep's open pipeline weighted by their historical stage close probability?" HubSpot says: "Reports cannot be created using multiple objects"

This isn't a Breeze shortcoming — it's a structural one shared by any single-object engine. Breeze acts on your CRM. DataLabs.store analyses it across the full relational picture. They're complementary, and the best setup uses both for what each does best.

AI Context Bridge adds three things that sit outside Breeze's scope: joins before aggregation (per-deal margin, multi-hop deal → contact → company → source, correctly weighted ratios), a full SQL receipt with every answer so the number is auditable, and your choice of frontier model — full Claude or ChatGPT, not a cost-optimised default. This isn't a Breeze replacement; it's an analytics layer on top of HubSpot.

Is it yet another AI snap-on app?

No — and this distinction matters. AI Context Bridge is a data bridge, not an AI application. There is no AI packaged into the product. No model is baked in, no prompts are hidden, no black-box reasoning is happening on our side.

You bring your own AI assistant. Think of AI Context Bridge as a specialised translator: it connects your chosen AI — Claude, ChatGPT, or any MCP-compatible model — to your HubSpot data through the Model Context Protocol standard. The AI does the reasoning; the bridge supplies the data in a form the AI can use efficiently.

You're in control: Choose any MCP-compatible AI assistant. Claude and ChatGPT work seamlessly today, and many open-source models support MCP. The power is in the connection — not in locking you into a specific platform. As models improve, you switch. Your data infrastructure stays put.

This architecture has a practical consequence: as frontier models get dramatically better each year, your analytical capability improves automatically. You're not waiting for a vendor to upgrade an embedded model — you simply point to the new one.

Technically, how does it work?

AI Context Bridge operates through a five-step process. The key architectural choice — and the one that makes complex analytics possible — is that your AI queries a dedicated SQL database, not HubSpot's API.

  1. Secure Connection: You authorise DataLabs.Store to access your HubSpot portal using OAuth — no passwords or API keys to manage.
  2. Complete Data Replication: We create a dedicated SQL database exclusively for your organisation and replicate your entire HubSpot portal into it — contacts, companies, deals, tickets, custom objects, and all relationships between them.
  3. MCP Bridge: You connect your AI assistant to our MCP server using a unique URL. The AI authenticates securely with your credentials.
  4. Intelligent Querying: When you ask questions, your AI uses specialised tools to understand your database schema, build optimised SQL queries, and retrieve exactly the data needed — including cross-object joins.
  5. Continuous Learning: The system saves frequently-used queries and business semantics for increasingly accurate future analysis.

For a detailed step-by-step walkthrough with visual explanations, see our comprehensive guide:

How AI Context Bridge Works

The key architectural difference: Unlike traditional API integrations that fetch data on-demand, we maintain a complete, structured copy of your data optimised for AI consumption. This enables complex analytical queries — joins, aggregations, window functions, historical trends — that are impossible or prohibitively slow through API calls.

HubSpot already offers their MCP free of charge. Why would anyone use yours?

HubSpot's MCP is a genuinely useful tool — especially for developer workflows, record updates, helpdesk automation, and quick CRM lookups. It's free, reads live data, and requires no sync. If you're building a support agent that needs to update a ticket or pull a contact record in real time, HubSpot's MCP is the right choice.

The limitation is structural, not a product quality issue. HubSpot's MCP routes through the CRM Search API — every question becomes a series of individual API calls. For analytical work that spans thousands of records across multiple object types, this creates real constraints:

Two Approaches, Different Jobs

Both extend HubSpot through AI — for fundamentally different use cases

HubSpot MCP

Transactional — live CRM operations

Primary Design
Real-time API interactions for transactional operations, record updates, and workflow automation
Best For
• Updating individual records
• Creating tasks and tickets
• Helpdesk and support agents
• Quick single-record lookups
• Developer integrations
Data Access
On-demand API calls — fetches specific records as needed via HubSpot's CRM Search API
Analytics
Constrained by API rate limits and single-object search. Complex cross-object analysis requires many sequential calls
Setup
Requires JSON config editing, HubSpot Private App creation, and Node.js installation

Read More on HubSpot

DataLabs.Store MCP

Analytical — deep cross-object queries

Primary Design
Analytical context bridge over a pre-populated, optimised SQL database designed for AI consumption
Best For
• Multi-table analytical queries
• Historical trend analysis
• Pipeline weighted by real close rates
• Executive dashboards and reporting
• Data-driven strategic decisions
Data Access
Complete SQL database replication — your entire HubSpot portal synchronised into a dedicated database, indexed for analytical queries
Analytics
Full relational SQL — joins, aggregations, CTEs, window functions, historical snapshots. No API rate limits
Setup
OAuth connection and URL configuration — no technical prerequisites beyond connecting your AI assistant

Try AI Context Bridge

The difference in one question: "Which deals are at risk this quarter based on engagement patterns and stage history?" — HubSpot's MCP makes dozens of sequential API calls and hits rate limits before completing. DataLabs.Store runs one SQL join across your complete dataset and returns the answer in seconds — with the query attached so you can verify the number.

The bottom line: HubSpot's MCP excels at real-time transactional operations. DataLabs.Store's AI Context Bridge excels at analytical work requiring joins, aggregations, and historical context. Many organisations benefit from both — one for acting on the CRM, one for deeply understanding it.

What is the difference between SQL Express hosting and Azure DB hosting? Why do you offer both?

We offer multiple hosting tiers because the primary cost driver is engagement volume, not record count. A portal with 500 contacts and five years of email logging can outgrow SQL Express faster than a portal with 100,000 contacts and minimal engagement history. Here's how to choose:

SQL Express — Recommended for Most

Hosted on our dedicated virtual servers.

Performance: Superior and consistently fast. Each server hosts only a handful of clients, ensuring you never compete for hardware resources. Queries execute quickly, reports generate smoothly, and your AI assistant gets rapid responses.

Storage limit: 10 GB database size.

Best for: Businesses prioritising responsive performance. Works well for portals with moderate engagement history.

Understanding the 10 GB Limit

Many HubSpot portals will eventually reach this cap, but it's driven almost entirely by engagement volume, not contact or deal counts:

Primary consumers: Emails logged in HubSpot consume the vast majority of database space. Meetings and calls can also take significant space depending on usage patterns.

Negligible impact: Custom objects, associations, contacts, companies, and deals — even with hundreds of thousands of records.

Key factors: How intensively engagements are logged, and how mature your portal is. A 5-year-old portal with extensive email logging will hit the limit faster than a brand-new portal with 10× more contacts.

Azure SQL Database

Hosted on Microsoft Azure's cloud infrastructure.

Performance: Good, but variable. Azure optimises for hardware efficiency across many customers. Complex analytical queries tend to run slower due to shared infrastructure and resource contention.

Storage limit: 250 GB — accommodates portals with years of intensive engagement history.

Best for: Mature portals with extensive email logging or very high-touch sales processes where engagement volume is substantial.

Upgrade: Individual approach — contact us to discuss. Azure offers several price tiers with different performance characteristics.

Custom SQL Server Hosting

Hosted on your own SQL Server infrastructure.

Performance: The absolute best — your dedicated hardware, your specifications, zero resource sharing.

Storage limit: Whatever you provision — no DataLabs.Store limitations.

Best for: Organisations already licensing SQL Server, enterprises with strict data residency requirements, or businesses demanding maximum performance.

Consideration: SQL Server licensing adds significant cost (typically $14,000+ for Standard, more for Enterprise). If you're already paying for SQL Server licenses, this option leverages your existing investment.

Setup: Available on request — we handle database setup and synchronisation, you provide the SQL Server instance. Full support included.

Performance in practice: SQL Express queries typically complete in 1–3 seconds. Azure DB queries may take 5–10 seconds. Custom SQL Server hosting often delivers sub-second responses for complex queries. The gap widens for multi-table analytical joins.

How to choose: Start with SQL Express. We monitor your database size and notify you if you're approaching the 10 GB limit. If your portal has extensive engagement history or you anticipate rapid growth in logged communications, discuss Azure DB or custom hosting with us upfront — we can predict your needs from your current HubSpot usage patterns.

Is it just an API wrapper over HubSpot's API?

No — and the difference is fundamental to why the analytics work. An API wrapper translates AI requests into HubSpot API calls, fetching data on demand. That sounds reasonable until you ask a question requiring a join across 10,000 deals, their stage history, engagement timeline, and owner records simultaneously.

Why API wrappers fall short for analytics

  • Rate limits: Complex questions require dozens or hundreds of sequential API calls. Rate limits interrupt the reasoning loop before it completes.
  • Latency: Each API call adds round-trip time. Analysing patterns across 10,000 deals means 10,000+ API calls — taking minutes or timing out entirely.
  • No pre-aggregation joins: APIs return data in predefined per-object formats. Joins and aggregations require fetching everything and processing locally — defeating the purpose of a server-side query.
  • No historical context: APIs show current state. How deals progressed through stages over time isn't available through standard CRM Search endpoints.
  • Schema opacity: HubSpot's API format requires extensive parsing; AI models reason better over a structured SQL schema with explicit relationships.

The independent analytical infrastructure approach

1. Complete data replication: We maintain a full copy of your HubSpot portal in a dedicated SQL database, updated continuously. Your AI queries this database directly.

2. Optimised schema: Data is restructured for analytical queries and AI comprehension. Relationships are pre-mapped, indices are optimised, and the structure is designed for the questions you actually ask.

3. Historical preservation: We track changes over time, enabling analysis of trends, progression, and historical patterns unavailable through API access.

4. Unlimited query complexity: Your AI can join 15 tables, aggregate millions of records, and compute complex metrics in a single SQL statement.

5. MCP-native tools: Specialised tools help AI understand your specific business context, learn from previous queries, and generate increasingly sophisticated analyses.

An API wrapper asks someone to run to the library, check out one book at a time, and read you specific pages. Our approach puts the entire library on your desk, organised exactly how you need it, ready for any question. The difference in speed, capability, and insight is the difference between a number and an answer.

Yes, we use HubSpot's API — but only for initial data synchronisation. Once your data is in your dedicated database, all AI interactions happen directly against that optimised structure. This separation of concerns is exactly what makes sophisticated analytics possible.

How secure is it? Is my data leaking to train AI?

Your data security and privacy are our highest priorities. The short answer on AI training: no, your data is not used to train AI models. Here's the full picture:

Complete Data Isolation

Your data exists in a dedicated SQL database that serves only your organisation. There's no shared infrastructure, no data pooling, no mixing with other customers — a private data vault, physically and logically isolated.

AI Training: Your Data Stays Yours

  • You use your own AI assistant (Claude, ChatGPT, etc.). We don't provide the AI — we provide the bridge.
  • When you use Claude or ChatGPT through their applications, you're protected by their privacy policies. Both Anthropic (Claude) and OpenAI (ChatGPT) have clear commitments: data accessed through their APIs and desktop applications is not used for training.
  • We never see your queries or your AI's responses. The conversation happens directly between you and your AI assistant; we only provide the data access layer.
  • Your database is read-only from our perspective. We replicate data from HubSpot into your database; we don't monitor, log, or access your AI interactions.

Authentication & Access Control

Access requires two factors:

1. MCP Server URL: Unique to your organisation, acts as the connection endpoint.

2. Secret Key: Your AI must authenticate with this key for every session. Without it, access is denied. Lost your key? We revoke it and issue a new one — previous keys become immediately invalid.

HubSpot Connection Security

We connect via OAuth 2.0 — the same secure protocol used by Google and Microsoft. We receive read-only access tokens, never your HubSpot password. You can revoke our access at any time from your HubSpot settings, and we'll automatically stop data synchronisation.

Encryption

All data in transit is encrypted using TLS 1.3. Database connections are encrypted. Authentication credentials are encrypted both in transit and at rest.

GDPR Compliance

We are fully GDPR compliant. You own your data. You can request complete data deletion at any time — we'll permanently remove your database within 24 hours. No backups, no archives, no remnants.

Transparency promise: If you have specific security concerns or require particular compliance certifications, please contact us. We're happy to discuss our security architecture in detail or work with your security team to address specific requirements.

Your responsibility: Keep your MCP secret key secure. Don't share it publicly or commit it to version control. Treat it like a password — it's the key to your data.

Still Have Questions?

We're here to help. Reach out to our team and we'll answer any questions you have about AI Context Bridge.

Contact Us