Bql Natural Language Finance Mcp

naftiko: 1.0.0-alpha2
info:
  title: Bql Natural Language Finance Mcp
  description: A capability over Bloomberg Query Language (BQL) that lets agents issue natural-language finance queries; the capability translates to BQL and returns shaped results.
  tags: [Naftiko, Bloomberg, BQL, Finance]
  created: '2026-05-01'
  modified: '2026-05-04'
binds:
- namespace: bloomberg-env
  keys: {BLOOMBERG_TOKEN: BLOOMBERG_TOKEN}
capability:
  consumes:
  - namespace: bql
    type: http
    baseUri: https://api.bloomberg.com
    authentication: {type: bearer, token: '{{BLOOMBERG_TOKEN}}'}
    resources:
    - {name: bql, path: /eap/bql/v1/query, operations: [{name: run-bql-query, method: POST, description: Run a BQL expression.}]}
  exposes:
  - type: rest
    address: 0.0.0.0
    port: 8080
    namespace: bql-natural-language-finance-mcp-rest
    description: REST surface for natural-language finance queries.
    resources:
    - {name: ask, path: /ask, operations: [{method: POST, name: ask-finance, description: Translate a natural-language finance question to BQL and return shaped results., call: bql.run-bql-query}]}
  - type: mcp
    address: 0.0.0.0
    port: 3010
    namespace: bql-natural-language-finance-mcp-mcp
    description: MCP for NL→BQL queries.
    tools:
    - {name: ask-finance, description: Ask a finance question in plain English; returns shaped BQL results., call: bql.run-bql-query}
  - type: skill
    address: 0.0.0.0
    port: 3011
    namespace: bql-natural-language-finance-mcp-skills
    description: Skill for NL→BQL.
    skills:
    - name: bql-natural-language-finance-mcp
      description: NL→BQL finance queries.
      location: file:///opt/naftiko/skills/bql-natural-language-finance-mcp
      allowed-tools: ask-finance
      tools:
      - {name: ask-finance, from: {sourceNamespace: bql-natural-language-finance-mcp-mcp, action: ask-finance}}